Windows Media Player 11 SDK IWMPContentPartner::InvokeCommandÂ
Previous | Next |
IWMPContentPartner::InvokeCommand
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 InvokeCommand method invokes a context menu command.
Syntax
HRESULT InvokeCommand( DWORD dwCommandID, BSTR location, VARIANT* pLocationContext, BSTR itemLocation, ULONG cItemIDs, ULONG* rgItemIDs );
Parameters
dwCommandID
[in] ID of the command to invoke. Windows Media Player previously obtained this command ID from the content partner plug-in by calling IWMPContentPartner::GetCommands.
location
[in] A library location constant that specifies the type of library view where the user right-clicked. For example, the constant g_szCPGenreID specifies that the user right-clicked in the view of a particular genre.
pLocationContext
[in] TheID of the specific view where the user right-clicked. For example, if location is g_szCPGenreID, then this parameter is the ID of the particular genre the user was viewing when he or she right-clicked.
itemLocation
[in] A library location constant that specifies the type of the media item or items that were selected when the user right-clicked. For example, the constant g_szCPAlbumID specifies that the user right-clicked when one or more albums were selected.
cItemIDs
[in] The number of items that were selected when the user right-clicked. This is the number of elements in the rgItemIDs array.
rgItemIDs
[in] An array that contains the IDs of the media items that were selected when the user right-clicked.
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. |
Requirements
Version: Windows Media Player 11
Header: contentpartner.h
See Also
Previous | Next |