SHObjectProperties function (shlobj_core.h)

[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

[in] hwnd

Type: HWND

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

[in] shopObjectType

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:").

[in] pszObjectName

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.

[in] pszPropertyPage

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