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 dalla funzione LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken o OpenThreadToken. Il token deve avere accesso TOKEN_QUERY. Per altre informazioni, vedere Diritti di accesso per gli oggetti Access-Token.
[out, optional] lpProfileDir
Tipo: LPTSTR
Puntatore a un buffer che, quando questa funzione restituisce correttamente, riceve il percorso della directory del profilo dell'utente specificato.
[in, out] lpcchSize
Tipo: LPDWORD
Specifica le dimensioni del buffer lpProfileDir , in TCHARs.
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 informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
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 di sottodirectory di questa directory, usare la funzione SHGetFolderPath (Windows XP e versioni precedenti) o 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 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
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | userenv.h |
Libreria | Userenv.lib |
DLL | Userenv.dll |