Metodo IKnownFolderManager::GetFolderByName (shobjidl_core.h)
Ottiene un oggetto che rappresenta una cartella nota identificata dal nome canonico. 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 GetFolderByName(
[in] LPCWSTR pszCanonicalName,
[out] IKnownFolder **ppkf
);
Parametri
[in] pszCanonicalName
Tipo: LPCWSTR
Puntatore al nome canonico non localizzato per la cartella nota, archiviato come stringa Unicode con terminazione Null. Se questa cartella è una cartella comune o per utente , questo valore viene usato anche come nome valore delle impostazioni del Registro di sistema "Cartelle della shell utente". Questo valore viene recuperato tramite il membro pszName della struttura KNOWNFOLDER_DEFINITION della cartella.
[out] ppkf
Tipo: IKnownFolder**
Quando termina, questo metodo contiene l'indirizzo di un puntatore all'oggetto IKnownFolder che rappresenta la cartella nota.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
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) |