Condividi tramite


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

Vedere anche

GetCurrentDirectory

GetWindowsDirectory

setCurrentDirectory

funzioni di informazioni di sistema