Funzione GetSystemDirectoryA (sysinfoapi.h)

Recupera il percorso della directory di sistema. La directory di sistema contiene file di sistema, ad esempio librerie e driver a collegamento dinamico.

Questa funzione viene fornita principalmente per la compatibilità. Le applicazioni devono archiviare il codice nella cartella Programmi e i dati persistenti nella cartella Dati applicazione nel profilo dell'utente. Per altre informazioni, vedere ShGetFolderPath.

Sintassi

UINT GetSystemDirectoryA(
  [out] LPSTR lpBuffer,
  [in]  UINT  uSize
);

Parametri

[out] lpBuffer

Puntatore al buffer per ricevere il percorso. Questo percorso non termina con una barra rovesciata a meno che la directory di sistema non sia la directory radice. Ad esempio, se la directory di sistema è denominata Windows\System32 sull'unità C, il percorso della directory di sistema recuperato da questa funzione è C:\Windows\System32.

[in] uSize

Dimensioni massime del buffer, in TCHAR.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è la lunghezza, in TCHAR, della stringa copiata nel buffer, senza includere il carattere null di terminazione. Se la lunghezza è maggiore delle dimensioni del buffer, il valore restituito è la dimensione del buffer necessaria per contenere il percorso, incluso il carattere Null di terminazione.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Le applicazioni non devono creare file nella directory di sistema. Se l'utente esegue una versione condivisa del sistema operativo, l'applicazione non ha accesso in scrittura alla directory di sistema.

Esempio

Per un esempio, vedere Recupero delle informazioni di sistema.

Nota

L'intestazione sysinfoapi.h definisce GetSystemDirectory 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	sysinfoapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

GetCurrentDirectory

GetWindowsDirectory

SetCurrentDirectory

Funzioni di informazioni di sistema