Funzione GetUserProfileDirectoryA (userenv.h)
Recupera il percorso della directory radice del profilo dell'utente specificato.
Sintassi
USERENVAPI BOOL GetUserProfileDirectoryA(
[in] HANDLE hToken,
[out, optional] LPSTR lpProfileDir,
[in, out] LPDWORD lpcchSize
);
Parametri
[in] hToken
Tipo: HANDLE
Token per l'utente, restituito dal LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessTokeno funzione OpenThreadToken. Il token deve avere accesso TOKEN_QUERY. Per altre informazioni, vedere Access Rights for Access-Token Objects.
[out, optional] lpProfileDir
Tipo: LPTSTR
Puntatore a un buffer che, quando questa funzione viene restituita correttamente, riceve il percorso della directory del profilo dell'utente specificato.
[in, out] lpcchSize
Tipo: LPDWORD
Specifica le dimensioni del buffer di
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 GetUserProfileDirectory in Windows XP:
C:\Documents and Settings\Joe
Di seguito è riportato un esempio del percorso restituito da GetUserProfileDirectory in Windows 7:
C:\Users\Joe
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 GetUserProfileDirectory 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 |