PROFILEINFOA-Struktur (profinfo.h)

Enthält Informationen, die beim Laden oder Entladen eines Benutzerprofils verwendet werden.

Syntax

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;

Angehörige

dwSize

Typ: DWORD-

Die Größe dieser Struktur in Byte.

dwFlags

Typ: DWORD-

Dieses Element kann eine der folgenden Flags sein:

PI_NOUI

Verhindert die Anzeige von Profilfehlermeldungen.

PI_APPLYPOLICY

Nicht unterstützt.

lpUserName

Typ: LPTSTR-

Ein Zeiger auf den Namen des Benutzers. Dieses Element wird als Basisname des Verzeichnisses verwendet, in dem ein neues Profil gespeichert werden soll.

lpProfilePath

Typ: LPTSTR-

Ein Zeiger auf das Roamingbenutzerprofil Pfad. Wenn der Benutzer kein Roamingprofil besitzt, kann dieses Element NULL-sein. Rufen Sie zum Abrufen des Roamingprofilpfads des Benutzers die NetUserGetInfo--Funktion auf, und geben Sie die Informationsstufe 3 oder 4 an. Weitere Informationen finden Sie in den Hinweisen.

lpDefaultPath

Typ: LPTSTR-

Ein Zeiger auf den Standardbenutzerprofilpfad. Dieses Element kann NULL-sein.

lpServerName

Typ: LPTSTR-

Ein Zeiger auf den Namen des validierenden Domänencontrollers im NetBIOS-Format.

lpPolicyPath

Typ: LPTSTR-

Wird nicht verwendet, auf NULL-festgelegt.

hProfile

Typ: HANDLE

Ein Handle für die HKEY_CURRENT_USER Registrierungsunterstruktur. Weitere Informationen finden Sie in den Hinweisen.

Bemerkungen

Verwenden Sie beim Angeben eines Pfads keine Umgebungsvariablen. Die LoadUserProfile--Funktion erweitert keine Umgebungsvariablen, z. B. %username%, in einem Pfad.

Wenn der LoadUserProfile- Aufruf erfolgreich zurückgegeben wird, empfängt das hProfile- Mitglied ein Registrierungsschlüsselhandle, das im Stammverzeichnis der Unterstruktur des Benutzers geöffnet wurde, geöffnet mit vollzugriff (KEY_ALL_ACCESS). Weitere Informationen finden Sie in den Abschnitten "Hinweise" in LoadUserProfile, Registrierungsschlüsselsicherheit und Zugriffsberechtigungenund Registrierungsstruktur.

Dienste und Anwendungen, die LoadUserProfile- aufrufen, sollten überprüfen, ob der Benutzer über ein Roamingprofil verfügt. Wenn der Benutzer über ein Roamingprofil verfügt, geben Sie seinen Pfad als lpProfilePath Mitglied dieser Struktur an.

Anmerkung

Der profinfo.h-Header definiert PROFILEINFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	profinfo.h (include Userenv.h)

Siehe auch

LoadUserProfile-

UnloadUserProfile-

übersicht über Benutzerprofile