External.sendMessage method

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note

This topic describes functionality designed for use by online stores. Use of this functionality outside the context of an online store is not supported.

The sendMessage method sends a message to the online store's plug-in.

Syntax

External.sendMessage(
  Msg,
  Param
)

Parameters

Msg [in]

String containing the message.

Param [in]

String containing parameters associated with the message.

Return value

This method does not return a value.

Remarks

The message is sent asynchronously. That is, this method returns immediately rather than waiting for the message to be processed. When the plug-in finishes processing the message, it calls the IWMPContentPartnerCallback::SendMessageComplete method, which in turn calls the script's OnSendMessageComplete event handler.

Requirements

Requirement Value
Version
Windows Media Player 11.
DLL
Wmp.dll

See also

External Object for Type 1 Online Stores

External.OnSendMessageComplete

IWMPContentPartner::SendMessage

IWMPContentPartnerCallback::SendMessageComplete