Funzione GetUserProfileDirectoryW (userenv.h)
Recupera il percorso della directory radice del profilo dell'utente specificato.
Sintassi
USERENVAPI BOOL GetUserProfileDirectoryW(
[in] HANDLE hToken,
[out, optional] LPWSTR 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 viene restituita correttamente, riceve il percorso della directory del profilo dell'utente specificato.
[in, out] lpcchSize
Tipo: LPDWORD
Specifica le dimensioni del buffer lpProfileDir , in TCHAR.
Se il buffer specificato da lpProfileDir non è sufficientemente grande 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 delle sottodirectory di questa directory, utilizzare 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 |