External.OnSendMessageComplete 事件

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意

本主题介绍专为在线商店使用而设计的功能。 不支持在在线商店上下文之外使用此功能。

当在线商店处理完消息时，将发生 OnSendMessageComplete 事件。 发现页上的脚本之前通过调用 External.sendMessage 发送了消息。

window.external.OnSendMessageComplete = FunctionName

可能的值

这是一个只写属性，用于指定在事件发生时Windows 媒体播放器调用的脚本中的函数的名称。

参数

处理此事件的函数具有以下参数。

味精

在 sendMessage 的 Msg 参数中传递的相同字符串。

参数

在 sendMessage 的 Param 参数中传递的相同字符串。

结果

包含消息处理结果的字符串。 请参阅“备注”。

注解

sendMessage 方法调用 IWMPContentPartner：：SendMessage，后者以异步方式返回。 也就是说，它会在在线商店完成消息处理之前返回。 当在线商店处理完消息时，它将调用 IWMPContentPartnerCallback：：SendMessageComplete，后者又调用脚本的 OnSendMessageComplete 事件处理程序。

当在线商店调用 IWMPContentPartnerCallback：：SendMessageComplete 时，它会在 bstrResult 参数中提供结果代码。 Windows 媒体播放器不解释该结果代码。 相反，Windows 媒体播放器将结果代码传递到 Result 参数中的 OnSendMessageComplete 事件处理程序。

OnSendMessageComplete 事件处理程序 (Msg、Param、Result) 的参数均不由 Windows 媒体播放器 解释。 参数仅对在线商店有意义。

要求

要求 值
版本
 Windows Media Player 11
DLL
Wmp.dll

另请参阅

类型 1 在线商店的外部对象

External.sendMessage

IWMPContentPartner：：SendMessage

IWMPContentPartnerCallback：：SendMessageComplete