Funzione SHGetSpecialFolderPathW (shlobj_core.h)
[SHGetSpecialFolderPath non è supportato. Usare invece SHGetFolderPath.
Recupera il percorso di una cartella speciale identificata dal relativo CSIDL.
Sintassi
BOOL SHGetSpecialFolderPathW(
HWND hwnd,
[out] LPWSTR pszPath,
[in] int csidl,
[in] BOOL fCreate
);
Parametri
hwnd
Tipo: HWND
Riservato.
[out] pszPath
Tipo: LPTSTR
Puntatore a una stringa con terminazione null che riceve l'unità e il percorso della cartella specificata. Questo buffer deve essere almeno MAX_PATH caratteri in dimensione.
[in] csidl
Tipo: int
CSIDL che identifica la cartella di interesse. Se viene specificata una cartella virtuale, questa funzione avrà esito negativo.
[in] fCreate
Tipo: BOOL
Indica se la cartella deve essere creata se non esiste già. Se questo valore è diverso da zero, viene creata la cartella. Se questo valore è zero, la cartella non viene creata.
Valore restituito
Tipo: BOOL
TRUE se ha esito positivo; in caso contrario, FALSE.
Commenti
Per questa funzione è necessario installare Microsoft Internet Explorer 4.0 Desktop Update.
Nota
L'intestazione shlobj_core.h definisce SHGetSpecialFolderPath come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shlobj_core.h (includere Shlobj.h, Shlobj_core.h) |
Libreria | Shell32.lib |
DLL | Shell32.dll (versione 4.71 o successiva) |