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 |