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)

Vedi anche

IKnownFolder

Esempio di cartelle note