IUserIdentityManager::Logon-Methode

[IUserIdentityManager::Logon wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen Benutzerkonten mit schnellem Benutzerwechsel und Remotedesktop.]

Zeigt dem Benutzer eine Benutzeroberfläche an, sodass der Benutzer eine Benutzeridentität auswählen kann. Bei erfolgreicher Ausführung wird die Benutzeridentität angemeldet und abgerufen.

Syntax

HRESULT Logon(
  [in]  HWND          hwndParent,
  [in]  DWORD         dwFlags,
  [out] IUserIdentity **ppIdentity
);

Parameter

hwndParent [in]

Typ: HWND

Ein HWND-Wert , der ein Fenster identifiziert, das nach dem Schließen der Anmeldebenutzeroberfläche in den Vordergrund geholt wird.

dwFlags [in]

Art: DWORD

Optionale Flags, um zu definieren, wie sich die Benutzeroberfläche verhält. Legen Sie auf UIL_FORCE_UI fest, um die Anzeige der Benutzeroberfläche zu erzwingen, auch wenn bereits eine Identität ausgewählt wurde.

ppIdentity [out]

Typ: IUserIdentity**

Die Adresse des Zeigers, der die ausgewählte Benutzeridentität empfängt.

Rückgabewert

Typ: HRESULT

Ergebnis des Anmeldevorgangs. Bei erfolgreicher Ausführung wird S_OK zurückgegeben. Andernfalls wird einer der folgenden Fehlercodes zurückgegeben.

Rückgabecode	Beschreibung
E_USER_CANCELLED	Der Benutzer hat den Anmeldevorgang über die Benutzeroberfläche abgebrochen.
E_OUTOFMEMORY	Die Benutzeridentität konnte nicht erstellt werden.
E_UNEXPECTED	Der Vorgang ist unerwartet fehlgeschlagen.
E_IDENTITIES_DISABLED	Die Identitätsverwaltung ist auf dem System deaktiviert.
S_IDENTITIES_DISABLED	Die Identitätsverwaltung ist auf dem System deaktiviert.
E_IDENTITY_CHANGING	Das System wechselt derzeit die Identitäten und kann den Vorgang nicht abschließen.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Ende des Supports (Client)	Windows 2000 Professional
Ende des Supports (Server)	Windows 2000 Server
Header	Msident.h
IDL	Msident.idl
DLL	Msident.dll

Siehe auch

IUserIdentityManager

IUserIdentityManager::Logoff

IUserIdentityManager::ManageIdentities