Windows Media Player 11 SDK IWMPContentPartnerCallback::SendMessageComplete 

  • Article

Windows Media Player SDK banner art

Previous Next

IWMPContentPartnerCallback::SendMessageComplete

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

The SendMessageComplete method notifies Windows Media Player that the online store has finished processing a message.

Syntax

  HRESULT SendMessageComplete(
  BSTR  bstrMsg,
  BSTR  bstrParam,
  BSTR  bstrResult
);

Parameters

bstrMsg

[in]  BSTR containing the message. See Remarks.

bstrParam

[in]  BSTR containing the message parameters.

bstrResult

[in]  BSTR containing the result.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.

Remarks

The SendMessageComplete method is part of a chain of methods that are called to pass messages from the discovery page to the content partner plug-in. The following list describes the chain of calls.

  1. The discovery page calls External.sendMessage, which has two string parameters: Msg and Param. Those two strings are meaningful only to the online store; they are not interpreted by Windows Media Player.
  2. Windows Media Player passes the two strings (Msg and Param) along to the plug-in by calling IWMPContentPartner::SendMessage.
  3. When the online store has finished processing the message, it passes the same two strings back to Windows Media Player by calling IWMPContentPartnerCallback::SendMessageComplete. It also passes a third string to SendMessageComplete that indicates the result of the message-processing attempt.
  4. Windows Media Player passes all three strings back to the discovery page by firing the External.OnSendMessageComplete event.

Requirements

Version: Windows Media Player 11

Header: contentpartner.h

See Also

Previous Next