External.OnLoginChange-Ereignis

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Hinweis

In diesem Thema werden Funktionen beschrieben, die für die Verwendung durch Onlineshops entwickelt wurden. Die Verwendung dieser Funktionalität außerhalb des Kontexts eines Onlineshops wird nicht unterstützt.

Das OnLoginChange-Ereignis tritt auf, wenn sich die Anmeldung des Benutzers status ändert oder wenn ein Anmeldeversuch fehlschlägt.

window.external.OnLoginChange = FunctionName

Mögliche Werte

Dies ist eine schreibgeschützte Eigenschaft, die den Namen der Funktion im Skript angibt, die beim Auftreten des Ereignisses aufgerufen Windows Medienwiedergabe.

Parameter

Die Funktion, die dieses Ereignis behandelt, nimmt keine Parameter an.

Bemerkungen

Dieses Ereignis tritt jedes Mal auf, wenn das Plug-In des Onlineshops IWMPContentPartnerCallback::Notify aufruft und wmpcnLoginStateChange im type-Parameter übergibt. Manchmal führt das Plug-In diesen Aufruf aus, um Windows Medienwiedergabe darüber zu informieren, dass sich der Anmeldestatus des Benutzers geändert hat. In anderen Situationen führt das Plug-In diesen Aufruf aus, um den Player darüber zu informieren, dass ein Anmeldeversuch fehlgeschlagen ist. Der pContext-Parameter der Notify-Methode gibt an, ob die Benachrichtigung für eine Änderung des Anmeldezustands oder für einen fehlgeschlagenen Anmeldeversuch gilt.

Da jeder Aufruf von Notify(wmpcnLoginStateChange, ...) bewirkt, dass Windows Medienwiedergabe das OnLoginChange-Ereignis auslöst, wird der OnLoginChange-Ereignishandler manchmal als Ergebnis einer Änderung des Anmeldezustands und manchmal als Ergebnis eines fehlgeschlagenen Anmeldeversuchs aufgerufen. Um den aktuellen Anmeldestatus des Benutzers zu bestimmen, muss der OnLoginChange-EreignishandlerExternal.userLoggedIn aufrufen.

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe 11
DLL	Wmp.dll

Siehe auch

Externes Objekt für Onlineshops vom Typ 1

External.attemptLogin

External.userLoggedIn