Funzione GetSystemWindowsDirectoryA (sysinfoapi.h)
Recupera il percorso della directory di Windows condivisa in un sistema multiutente.
Questa funzione viene fornita principalmente per la compatibilità. Le applicazioni devono archiviare il codice nella cartella Programmi e dati persistenti nella cartella Dati applicazione nel profilo dell'utente. Per altre informazioni, vedere ShGetFolderPath.
Sintassi
UINT GetSystemWindowsDirectoryA(
[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 Windows non sia la directory radice. Ad esempio, se la directory di Windows è denominata Windows nell'unità C, il percorso della directory di Windows recuperato da questa funzione è C:\Windows. Se il sistema è stato installato nella directory radice dell'unità C, il percorso recuperato è C:.
[in] uSize
Dimensioni massime del buffer specificato dal parametro lpBuffer , in TCHARs.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è la lunghezza della stringa copiata nel buffer, in TCHARs, non incluso il carattere null di terminazione.
Se la lunghezza è maggiore della dimensione del buffer, il valore restituito è la dimensione del buffer necessaria per contenere il percorso.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
In un sistema che esegue Servizi terminal, ogni utente ha una directory di Windows univoca. La directory di Windows di sistema è condivisa da tutti gli utenti, quindi è la directory in cui un'applicazione deve archiviare l'inizializzazione e i file della Guida che si applicano a tutti gli utenti.
Con Servizi terminal, la funzione GetSystemWindowsDirectory recupera il percorso della directory di Windows di sistema, mentre la funzione GetWindowsDirectory recupera il percorso di una directory di Windows privata per ogni utente. In un sistema a utente singolo GetSystemWindowsDirectory corrisponde a GetWindowsDirectory.
Nota
L'intestazione sysinfoapi.h definisce GetSystemWindowsDirectory come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | sysinfoapi.h (includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |