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