SHOpenPropSheetA function (shlobj.h)

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

Creates a property sheet from a list of registry keys that contain the CLSIDs of the individual sheets, then opens the property sheet.

Syntax

BOOL SHOpenPropSheetA(
  [in, optional] LPCSTR        pszCaption,
  [in, optional] HKEY []       ahkeys,
                 UINT          ckeys,
  [in, optional] const CLSID   *pclsidDefault,
  [in]           IDataObject   *pdtobj,
  [in, optional] IShellBrowser *psb,
  [in, optional] LPCSTR        pStartPage
);

Parameters

[in, optional] pszCaption

Type: LPCTSTR

A pointer to a string that contains the caption for the property sheet. This value can be NULL if no caption is needed.

[in, optional] ahkeys

Type: HKEY[]

An array of registry keys that represent the CLSIDs of the individual property sheets.

ckeys

Type: UINT

UINT value that specifies the number of property sheets in the array specified by ahkeys.

[in, optional] pclsidDefault

Type: const CLSID*

A pointer to the default CLSID. This value can be NULL.

[in] pdtobj

Type: IDataObject*

A pointer to an IDataObject, an OLE object that can be used to carry out actions on the property sheet(s).

[in, optional] psb

Type: IShellBrowser*

Not used.

[in, optional] pStartPage

Type: LPCTSTR

A pointer to a string that specifies the start page. This value can be NULL.

Return value

Type: BOOL

Returns TRUE if the property sheet was successfully created; otherwise, FALSE.

Remarks

Requirements