Evento External.OnSendMessageComplete

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Observação

Este tópico descreve a funcionalidade projetada para uso por lojas online. Não há suporte para o uso dessa funcionalidade fora do contexto de um repositório online.

O evento OnSendMessageComplete ocorre quando o repositório online termina de processar uma mensagem. O script na página de descoberta enviou anteriormente a mensagem chamando External.sendMessage.

window.external.OnSendMessageComplete = FunctionName

Valores possíveis

Essa é uma propriedade somente gravação que especifica o nome da função no script que Reprodutor Multimídia do Windows chama quando o evento ocorre.

Parâmetros

A função que manipula esse evento tem os seguintes parâmetros.

Msg

A mesma cadeia de caracteres que foi passada no parâmetro Msg de sendMessage.

Param

A mesma cadeia de caracteres que foi passada no parâmetro Param de sendMessage.

Resultado

Cadeia de caracteres que contém o resultado do tratamento de mensagens. Consulte Observações.

Comentários

O método sendMessage chama IWMPContentPartner::SendMessage, que retorna de forma assíncrona. Ou seja, ele retorna antes que o repositório online conclua o processamento da mensagem. Quando o repositório online termina de processar a mensagem, ele chama IWMPContentPartnerCallback::SendMessageComplete, que por sua vez chama o manipulador de eventos OnSendMessageComplete do script.

Quando o repositório online chama IWMPContentPartnerCallback::SendMessageComplete, ele fornece um código de resultado no parâmetro bstrResult . Reprodutor Multimídia do Windows não interpreta esse código de resultado. Em vez disso, Reprodutor Multimídia do Windows passa o código de resultado para o manipulador de eventos OnSendMessageComplete no parâmetro Result.

Nenhum dos parâmetros (Msg, Param, Result) do manipulador de eventos OnSendMessageComplete é interpretado por Reprodutor Multimídia do Windows. Os parâmetros têm significado apenas para o repositório online.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows 11
DLL	Wmp.dll

Confira também

Objeto externo para repositórios online do tipo 1

External.sendMessage

IWMPContentPartner::SendMessage

IWMPContentPartnerCallback::SendMessageComplete