Struttura PROFILEINFOA (profinfo.h)

Contiene informazioni utilizzate durante il caricamento o lo scaricamento di un profilo utente.

Sintassi

typedef struct _PROFILEINFOA {
  DWORD             dwSize;
  DWORD             dwFlags;
  MIDL_STRING LPSTR lpUserName;
  MIDL_STRING LPSTR lpProfilePath;
  MIDL_STRING LPSTR lpDefaultPath;
  MIDL_STRING LPSTR lpServerName;
  MIDL_STRING LPSTR lpPolicyPath;
#if ...
  ULONG_PTR         hProfile;
#else
  HANDLE            hProfile;
#endif
} PROFILEINFOA, *LPPROFILEINFOA;

Members

dwSize

Tipo: DWORD

Dimensioni di questa struttura, in byte.

dwFlags

Tipo: DWORD

Questo membro può essere uno dei flag seguenti:

PI_NOUI

Impedisce la visualizzazione dei messaggi di errore del profilo.

PI_APPLYPOLICY

Non supportato.

lpUserName

Tipo: LPTSTR

Puntatore al nome dell'utente. Questo membro viene usato come nome di base della directory in cui archiviare un nuovo profilo.

lpProfilePath

Tipo: LPTSTR

Puntatore al percorso del profilo utente mobile . Se l'utente non dispone di un profilo mobile, questo membro può essere NULL. Per recuperare il percorso del profilo mobile dell'utente, chiamare la funzione NetUserGetInfo , specificando il livello di informazioni 3 o 4. Per altre informazioni, vedere la sezione Osservazioni.

lpDefaultPath

Tipo: LPTSTR

Puntatore al percorso predefinito del profilo utente. Questo membro può essere NULL.

lpServerName

Tipo: LPTSTR

Puntatore al nome del controller di dominio di convalida, in formato NetBIOS.

lpPolicyPath

Tipo: LPTSTR

Non usato, impostare su NULL.

hProfile

Tipo: HANDLE

Handle per il sottoalbero del Registro di sistema HKEY_CURRENT_USER. Per altre informazioni, vedere la sezione Osservazioni.

Commenti

Non usare le variabili di ambiente quando si specifica un percorso. La funzione LoadUserProfile non espande le variabili di ambiente, ad esempio %username%, in un percorso.

Quando la chiamata a LoadUserProfile viene restituita correttamente, il membro hProfile riceve un handle di chiave del Registro di sistema aperto alla radice del sottoalbero dell'utente, aperto con accesso completo (KEY_ALL_ACCESS). Per altre informazioni, vedere le sezioni Osservazioni in LoadUserProfile, Sicurezza delle chiavi del Registro di sistema e Diritti di accesso e Hives del Registro di sistema.

I servizi e le applicazioni che chiamano LoadUserProfile devono verificare se l'utente ha un profilo mobile. Se l'utente ha un profilo mobile, specificarne il percorso come membro lpProfilePath di questa struttura.

Nota

L'intestazione profinfo.h definisce PROFILEINFO 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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	profinfo.h (include Userenv.h)

Vedi anche

LoadUserProfile

UnloadUserProfile

Panoramica dei profili utente