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 viene restituita 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 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 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 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 GetDefaultUserProfileDirectory 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 |