Funzione GetDefaultUserProfileDirectoryA (userenv.h)
Recupera il percorso della radice del profilo dell'utente predefinito.
Sintassi
USERENVAPI BOOL GetDefaultUserProfileDirectoryA(
[out, optional] LPSTR lpProfileDir,
[in, out] LPDWORD lpcchSize
);
Parametri
[out, optional] lpProfileDir
Tipo: LPTSTR
Puntatore a un buffer che, quando questa funzione restituisce correttamente, riceve il percorso della directory del profilo dell'utente predefinito. Impostare questo valore su NULL per determinare le dimensioni necessarie del buffer.
[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 GetDefaultUserProfileDirectory in Windows XP:
C:\Documents and Settings\Default User
Di seguito è riportato un esempio del percorso restituito da GetDefaultUserProfileDirectory in Windows 7:
C:\Users\Default
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 GetDefaultUserProfileDirectory 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
| Requisito | Valore |
|---|---|
| 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 |