Funzione SHGetFolderLocation (shlobj_core.h)

Deprecato. Recupera il percorso di una cartella come struttura ITEMIDLIST .

Sintassi

SHSTDAPI SHGetFolderLocation(
  [in]  HWND             hwnd,
  [in]  int              csidl,
  [in]  HANDLE           hToken,
  [in]  DWORD            dwFlags,
  [out] PIDLIST_ABSOLUTE *ppidl
);

Parametri

[in] hwnd

Tipo: HWND

Riservato.

[in] csidl

Tipo: int

Valore CSIDL che identifica la cartella da individuare. Le cartelle associate agli ELENCHI CSID potrebbero non esistere in un determinato sistema.

[in] hToken

Tipo: HANDLE

Token di accesso che può essere usato per rappresentare un determinato utente. In genere è impostato su NULL, ma potrebbe essere necessario quando sono presenti più utenti per tali cartelle considerate come appartenenti a un singolo utente. La cartella più comunemente usata di questo tipo è Documenti personali. L'applicazione chiamante è responsabile della rappresentazione corretta quando hToken non è NULL. Deve avere privilegi di sicurezza appropriati per l'utente specifico e l'hive del Registro di sistema dell'utente deve essere attualmente montato. Per altre discussioni sui problemi di controllo degli accessi, vedere Controllo di accesso.

L'assegnazione del parametro hToken a un valore di -1 indica l'utente predefinito. Ciò consente ai client di SHGetFolderLocation di trovare percorsi delle cartelle (ad esempio la cartella Desktop) per l'utente predefinito. Il profilo utente predefinito viene duplicato quando viene creato un nuovo account utente e include cartelle speciali come Documenti personali e Desktop. Tutti gli elementi aggiunti alla cartella Utente predefinito vengono visualizzati anche in qualsiasi nuovo account utente.

[in] dwFlags

Tipo: DWORD

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

Indirizzo di un puntatore a una struttura dell'elenco di identificatori di elemento che specifica la posizione della cartella rispetto alla radice dello spazio dei nomi (desktop). Il parametro ppidl è impostato su NULL in caso di errore. L'applicazione chiamante è responsabile della liberazione di questa risorsa chiamando ILFree.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario, incluso quanto segue:

Commenti

Questa funzione è un superset di SHGetSpecialFolderLocation, incluso nelle versioni precedenti di Shell.

Requisiti

Vedi anche

IKnownFolder::GetIDList