Funzione GetSystemDirectoryW (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 del profilo dell'utente. Per altre informazioni, vedere ShGetFolderPath.
Sintassi
UINT GetSystemDirectoryW(
[out] LPWSTR 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 nell'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 TCHARs, 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 ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
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.
Esempi
Per un esempio, vedere Getting System Information.
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 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 [app desktop | App UWP] |
server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
piattaforma di destinazione | Finestre |
intestazione |
sysinfoapi.h (include Windows.h) |
libreria |
Kernel32.lib |
dll | Kernel32.dll |