Condividi tramite


Funzione SHOpenPropSheetA (shlobj.h)

[SHOpenPropSheet è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Crea una finestra delle proprietà da un elenco di chiavi del Registro di sistema che contengono il CLSIDdei singoli fogli, quindi apre la finestra delle proprietà.

Sintassi

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

Parametri

[in, optional] pszCaption

Tipo: LPCTSTR

Puntatore a una stringa contenente il didascalia per la finestra delle proprietà. Questo valore può essere NULL se non è necessaria alcuna didascalia.

[in, optional] ahkeys

Tipo: HKEY[]

Matrice di chiavi del Registro di sistema che rappresentano il CLSIDdelle singole finestre delle proprietà.

ckeys

Tipo: UINT

Valore UINT che specifica il numero di finestre delle proprietà nella matrice specificata da ahkeys.

[in, optional] pclsidDefault

Tipo: const CLSID*

Puntatore al CLSID predefinito. Questo valore può essere NULL.

[in] pdtobj

Tipo: IDataObject*

Puntatore a un IDataObject, oggetto OLE che può essere utilizzato per eseguire azioni nelle finestre delle proprietà.

[in, optional] psb

Tipo: IShellBrowser*

Non usato.

[in, optional] pStartPage

Tipo: LPCTSTR

Puntatore a una stringa che specifica la pagina iniziale. Questo valore può essere NULL.

Valore restituito

Tipo: BOOL

Restituisce TRUE se la finestra delle proprietà è stata creata correttamente; in caso contrario, FALSE.

Commenti

Nota

L'intestazione shlobj.h definisce SHOpenPropSheet come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj.h
Libreria Shell32.lib
DLL Shell32.dll (versione 5.0 o successiva)