Windows Media Player 11 SDK IWMPContentPartnerCallback::SendMessageComplete
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.
- 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.
- Windows Media Player passes the two strings (Msg and Param) along to the plug-in by calling IWMPContentPartner::SendMessage.
- 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.
- 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 |