Metodo IKnownFolderManager::GetFolder (shobjidl_core.h)
Ottiene un oggetto che rappresenta una cartella nota identificata dalla proprietà KNOWNFOLDERID. L'oggetto consente di eseguire query su determinate proprietà di cartella, ottenere il percorso corrente della cartella, reindirizzare la cartella a un'altra posizione e ottenere il percorso della cartella come ITEMIDLIST.
Sintassi
HRESULT GetFolder(
[in] REFKNOWNFOLDERID rfid,
[out] IKnownFolder **ppkf
);
Parametri
[in] rfid
Tipo: REFKNOWNFOLDERID
Riferimento a KNOWNFOLDERID.
[out] ppkf
Tipo: IKnownFolder**
Quando termina, questo metodo contiene un puntatore di interfaccia all'oggetto IKnownFolder che rappresenta la cartella.
Valore restituito
Tipo: HRESULT
Restituisce S_OK in caso di esito positivo o un valore di errore, incluso quanto segue:
| Codice restituito | Descrizione |
|---|---|
|
Tra le altre cose, questo valore può indicare che il parametro rfid fa riferimento a un KNOWNFOLDERID che non è presente nel sistema. Non tutti i valori KNOWNFOLDERID sono presenti in tutti i sistemi. Usare IKnownFolderManager::GetFolderIds per recuperare il set di valori KNOWNFOLDERID per il sistema corrente. |
Commenti
Per chiamare questo metodo, il chiamante deve avere almeno privilegi utente.
Quando usare
Usare questo metodo quando si conosce esattamente quale cartella nota si sta cercando e si vuole accedervi direttamente.Requisiti
| Requisito | Valore |
|---|---|
| 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) |
| DLL | Shell32.dll |