Metodo IKnownFolder::GetFolderDefinition (shobjidl_core.h)
Recupera una struttura contenente gli elementi di definizione di una cartella nota, che include la categoria, il nome, il percorso, il percorso, la descrizione, la descrizione comando, l'icona e altre proprietà.
Sintassi
HRESULT GetFolderDefinition(
[out] KNOWNFOLDER_DEFINITION *pKFD
);
Parametri
[out] pKFD
Tipo: KNOWNFOLDER_DEFINITION*
Quando questo metodo restituisce, contiene un puntatore alla struttura KNOWNFOLDER_DEFINITION . Quando non è più necessaria, l'applicazione chiamante è responsabile della chiamata a FreeKnownFolderDefinitionFields per liberare questa risorsa.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Quando un'applicazione di terze parti crea una propria cartella nota, la definisce con una struttura di KNOWNFOLDER_DEFINITION , quindi la registrazione con il sistema. Tutte le informazioni sulla definizione della cartella note registrate, fornite dal sistema o create dall'applicazione, possono essere recuperate tramite questo metodo.
Per chiamare questo metodo, il chiamante deve avere almeno privilegi Utente.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | shobjidl_core.h (include Shobjidl.h) |