Funzione GetAllUsersProfileDirectoryA (userenv.h)
Recupera il percorso della radice della directory che contiene i dati del programma condivisi da tutti gli utenti.
Sintassi
USERENVAPI BOOL GetAllUsersProfileDirectoryA(
[out, optional] LPSTR lpProfileDir,
[in, out] LPDWORD lpcchSize
);
Parametri
[out, optional] lpProfileDir
Tipo: LPTSTR
Puntatore a un buffer che, quando questa funzione viene restituita correttamente, riceve il percorso. Impostare questo valore su NULL per determinare le dimensioni necessarie del buffer, incluso il carattere Null di terminazione.
[in, out] lpcchSize
Tipo: LPDWORD
Puntatore alla dimensione del buffer lpProfileDir
Se il buffer specificato da lpProfileDir non è sufficiente o lpProfileDir è NULL, la funzione ha esito negativo e questo parametro riceve le dimensioni del buffer necessarie, incluso il carattere null di terminazione.
Valore restituito
Tipo: bool
true se ha esito positivo; in caso contrario, FALSE. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
Di seguito è riportato un esempio del percorso restituito da GetAllUsersProfileDirectory in Windows XP:
C:\Documents and Settings\All Users
Di seguito è riportato un esempio del percorso restituito da GetAllUsersProfileDirectory in Windows 7:
C:\ProgramData
Per ottenere i percorsi delle sottodirectory di questa directory, utilizzare la funzione SHGetFolderPath (Windows XP e versioni precedenti) o FUNZIONE SHGetKnownFolderPath (Windows Vista).
Nota
L'intestazione userenv.h definisce GetAllUsersProfileDirectory 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 |
userenv.h |
| libreria |
Userenv.lib |
| dll | Userenv.dll |