SHOpenPropSheetA function

[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(
  LPCSTR        pszCaption,
  HKEY []       ahkeys,
  UINT          ckeys,
  const CLSID   *pclsidDefault,
  IDataObject   *pdtobj,
  IShellBrowser *psb,
  LPCSTR        pStartPage
);

Parameters

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.

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.

pclsidDefault

Type: const CLSID*

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

pdtobj

Type: IDataObject*

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

psb

Type: IShellBrowser*

Not used.

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.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shlobj.h
Library Shell32.lib
DLL Shell32.dll (version 5.0 or later)