Funzione GetProfilesDirectoryA (userenv.h)
Recupera il percorso della directory radice in cui sono archiviati i profili utente.
Sintassi
USERENVAPI BOOL GetProfilesDirectoryA(
[out] LPSTR lpProfileDir,
[in, out] LPDWORD lpcchSize
);
Parametri
[out] lpProfileDir
Tipo: LPTSTR
Puntatore a un buffer che, quando questa funzione viene restituita correttamente, riceve il percorso della directory dei profili. Impostare questo valore su NULL per determinare le dimensioni necessarie del buffer.
[in, out] lpcchSize
Tipo: LPDWORD
Specifica le dimensioni del buffer lpProfilesDir, in TCHARs.
Se il buffer specificato da lpProfilesDir non è sufficiente o lpProfilesDir è 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 GetProfilesDirectory in Windows XP:
C:\Documents and Settings
Di seguito è riportato un esempio del percorso restituito da GetProfilesDirectory in Windows 7:
C:\Users
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 GetProfilesDirectory 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 |