Funzione SHGetSpecialFolderPathA (shlobj_core.h)

Articolo
11/20/2024

[ SHGetSpecialFolderPath non è supportato. Usare invece SHGetFolderPath.]

Recupera il percorso di una cartella speciale, identificata dal relativo CSIDL.

Sintassi

BOOL SHGetSpecialFolderPathA(
        HWND  hwnd,
  [out] LPSTR 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 avere dimensioni di almeno MAX_PATH caratteri.

[in] csidl

Tipo: int

Un CSIDL che identifica la cartella di interesse. Se si specifica 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.

Osservazioni

Per rendere disponibile 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlobj_core.h (includere Shlobj.h, Shlobj_core.h)
libreria	Shell32.lib
dll	Shell32.dll (versione 4.71 o successiva)

Condividi tramite