Condividi tramite

Struttura PROFILEINFOA (profinfo.h)

  • Articolo

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;

Membri

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 profilo utente mobile percorso. 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 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, impostato su NULL.

hProfile

Tipo: HANDLE

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

Osservazioni

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 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, diritti di accesso e sicurezza delle chiavi del Registro di sistemae 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 dispone di 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 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]
intestazione profinfo.h (include Userenv.h)

Vedere anche

LoadUserProfile

unloadUserProfile

Panoramica dei profili utente