Funzione SHGetSpecialFolderPathW (shlobj_core.h)

Articolo
03/02/2024

[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)

Condividi tramite