Share via


GetProfileType-Funktion (userenv.h)

Ruft den Typ des Profils ab, das für den aktuellen Benutzer geladen wurde.

Syntax

USERENVAPI BOOL GetProfileType(
  [out] DWORD *dwFlags
);

Parameter

[out] dwFlags

Typ: DWORD*

Zeiger auf eine Variable, die den Profiltyp empfängt. Wenn die Funktion erfolgreich ist, legt sie einen oder mehrere der folgenden Werte fest:

PT_MANDATORY

Der Benutzer verfügt über obligatorische Benutzerprofile.

PT_ROAMING

Der Benutzer verfügt über Roamingbenutzerprofile.

PT_ROAMING_PREEXISTING

Der Benutzer verfügt über ein Roamingbenutzerprofil , das auf einem anderen PC erstellt wurde und heruntergeladen wird. Dieser Profiltyp impliziert PT_ROAMING.

PT_TEMPORARY

Der Benutzer verfügt über ein temporäres Benutzerprofil; sie wird beim Abmelden gelöscht.

Rückgabewert

Typ: BOOL

TRUE , wenn erfolgreich; andernfalls FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn das Benutzerprofil noch nicht geladen ist, schlägt die Funktion fehl.

Beachten Sie, dass der Aufrufer KEY_READ Zugriff auf HKEY_LOCAL_MACHINE haben muss. Dieses Zugriffsrecht wird standardmäßig gewährt. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.

Wenn der Profiltyp PT_ROAMING_PREEXISTING ist, initialisieren Explorer Standardprogrammzuordnungen nicht erneut, wenn ein Profil zum ersten Mal auf einem Computer geladen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile userenv.h
Bibliothek Userenv.lib
DLL Userenv.dll

Weitere Informationen

LoadUserProfile

Übersicht über Benutzerprofile

Referenz zu Benutzerprofilen