External.OnSendMessageComplete-Ereignis

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

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 Online-Shops wird nicht unterstützt.

Das OnSendMessageComplete-Ereignis tritt auf, wenn der Online-Shop die Verarbeitung einer Nachricht abgeschlossen hat. Ein Skript auf der Ermittlungsseite hat die Nachricht zuvor durch Aufrufen von External.sendMessage gesendet.

window.external.OnSendMessageComplete = FunctionName

Mögliche Werte

Dies ist eine schreibgeschützte Eigenschaft, die den Namen der Funktion im Skript angibt, die Windows Medienwiedergabe aufruft, wenn das Ereignis eintritt.

Parameter

Die Funktion, die dieses Ereignis behandelt, weist die folgenden Parameter auf.

Msg

Dieselbe Zeichenfolge, die im Msg-Parameter von sendMessage übergeben wurde.

Param

Dieselbe Zeichenfolge, die im Param-Parameter von sendMessage übergeben wurde.

Ergebnis

Zeichenfolge , die das Ergebnis der Nachrichtenverarbeitung enthält. Siehe Hinweise.

Hinweise

Die sendMessage-Methode ruft IWMPContentPartner::SendMessage auf, die asynchron zurückgibt. Das heißt, es wird zurückgegeben, bevor der Online-Shop die Verarbeitung der Nachricht abgeschlossen hat. Wenn der Online-Store die Verarbeitung der Nachricht abgeschlossen hat, ruft er IWMPContentPartnerCallback::SendMessageComplete auf, wodurch wiederum der OnSendMessageComplete-Ereignishandler des Skripts aufgerufen wird.

Wenn der Online-Store IWMPContentPartnerCallback::SendMessageComplete aufruft, stellt er einen Ergebniscode im bstrResult-Parameter bereit. Windows Medienwiedergabe interpretiert diesen Ergebniscode nicht. Stattdessen übergibt Windows Medienwiedergabe den Ergebniscode an den OnSendMessageComplete-Ereignishandler im Result-Parameter.

Keiner der Parameter (Msg, Param, Result) des OnSendMessageComplete-Ereignishandlers wird von Windows Medienwiedergabe interpretiert. Die Parameter haben nur eine Bedeutung für den Online-Shop.

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe 11
DLL	Wmp.dll

Siehe auch

Externes Objekt für Onlineshops vom Typ 1

External.sendMessage

IWMPContentPartner::SendMessage

IWMPContentPartnerCallback::SendMessageComplete