Invokes the Properties context menu command on a Shell object.

Syntax

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

Parameters

hwnd

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

shopObjectType

[in] 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] 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] 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

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

Remarks

Note  This function is available through Microsoft Windows XP Service Pack 2 (SP2) and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.

Function Information

Minimum DLL Version	shell32.dll version 5.0 or later
Custom Implementation	No
Header	shlobj.h
Import library	shell32.lib
Minimum operating systems	Windows 2000