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 i dati persistenti nella cartella Dati applicazione del 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 recuperata da questa funzione è C:\Windows. Se il sistema è stato installato nella directory radice dell'unità C, il percorso recuperato è C:.
[in] uSize
Dimensione massima del buffer specificato dal parametro lpBuffer
Valore restituito
Se la funzione ha esito positivo, il valore restituito è la lunghezza della stringa copiata nel buffer, in TCHARs, 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.
Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
In un sistema che esegue Servizi terminal, ogni utente ha una directory di Windows univoca. La directory di sistema di Windows è 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
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 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 [solo app desktop] |
| server minimo supportato | Windows 2000 Server [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
sysinfoapi.h (include Windows.h) |
| libreria |
Kernel32.lib |
| dll | Kernel32.dll |