Evento External.OnSendMessageComplete

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Nota:

En este tema se describe la funcionalidad diseñada para su uso por las tiendas en línea. No se admite el uso de esta funcionalidad fuera del contexto de una tienda en línea.

El evento OnSendMessageComplete se produce cuando la tienda en línea ha terminado de procesar un mensaje. El script de la página de detección envió previamente el mensaje llamando a External.sendMessage.

window.external.OnSendMessageComplete = FunctionName

Valores posibles

Se trata de una propiedad de solo escritura que especifica el nombre de la función en el script que Reproductor multimedia de Windows llama cuando se produce el evento.

Parámetros

La función que controla este evento tiene los parámetros siguientes.

Msg

La misma cadena que se pasó en el parámetro Msg de sendMessage.

Param

La misma cadena que se pasó en el parámetro Param de sendMessage.

Resultado

Cadena que contiene el resultado del control de mensajes. Vea la sección Comentarios.

Comentarios

El método sendMessage llama a IWMPContentPartner::SendMessage, que devuelve de forma asincrónica. Es decir, devuelve antes de que la tienda en línea termine de procesar el mensaje. Cuando la tienda en línea termina de procesar el mensaje, llama a IWMPContentPartnerCallback::SendMessageComplete, que a su vez llama al controlador de eventos OnSendMessageComplete del script.

Cuando la tienda en línea llama a IWMPContentPartnerCallback::SendMessageComplete, proporciona un código de resultado en el parámetro bstrResult . Reproductor multimedia de Windows no interpreta ese código de resultado. En su lugar, Reproductor multimedia de Windows pasa el código de resultado junto al controlador de eventos OnSendMessageComplete en el parámetro Result.

Ninguno de los parámetros (Msg, Param, Result) del controlador de eventos OnSendMessageComplete se interpreta mediante Reproductor multimedia de Windows. Los parámetros solo tienen significado para la tienda en línea.

Requisitos

Requisito	Value
Versión	Reproductor de Windows Media 11
Archivo DLL	Wmp.dll

Consulte también

Objeto externo para tiendas en línea de tipo 1

External.sendMessage

IWMPContentPartner::SendMessage

IWMPContentPartnerCallback::SendMessageComplete