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 |
|---|