Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
SHObjectProperties
Collapse the table of content
Expand the table of content

SHObjectProperties function

[SHObjectProperties is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Invokes the Properties context menu command on a Shell object.

Syntax


BOOL SHObjectProperties(
  _In_ HWND   hwnd,
  _In_ DWORD  shopObjectType,
  _In_ PCWSTR pszObjectName,
  _In_ PCWSTR pszPropertyPage
);

Parameters

hwnd [in]

Type: HWND

The handle of the parent window of the dialog box. This value can be NULL.

shopObjectType [in]

Type: DWORD

A flag value that specifies the type of object.

SHOP_PRINTERNAME

pszObjectName contains the friendly name of a printer.

SHOP_FILEPATH

pszObjectName contains a fully qualified file name.

SHOP_VOLUMEGUID

pszObjectName contains either (a) a volume name of the form \\?\Volume{GUID}\, where {GUID} is a globally unique identifier (for example, "\\?\Volume\{2eca078d-5cbc-43d3-aff8-7e8511f60d0e}\)", or (b) a drive path (for example, "C:\").

pszObjectName [in]

Type: PCWSTR

A null-terminated Unicode string that contains the object name. The contents of the string are determined by the flag set in shopObjectType.

pszPropertyPage [in]

Type: PCWSTR

A null-terminated Unicode string that contains the name of the property sheet page to be opened initially. Set this parameter to NULL to specify the default page.

Return value

Type: BOOL

TRUE if the command is successfully invoked; otherwise, FALSE.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP with SP2

End of server support

Windows Server 2003

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.0 or later)

 

 

Community Additions

ADD
Show:
© 2015 Microsoft