Windows Media Player 11 SDK IWMPContentPartner::RefreshLicense
Previous | Next |
IWMPContentPartner::RefreshLicense
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 RefreshLicense method initiates the update of a license for the specified media file.
Syntax
HRESULT RefreshLicense( DWORD dwCookie, VARIANT_BOOL fLocal, BSTR bstrURL, WMPStreamingType type, ULONG contentID, BSTR bstrRefreshReason, VARIANT* pReasonContext );
Parameters
dwCookie
[in] A cookie that identifies the update request. When the online store has finished updating the license, it passes this cookie to IWMPContentPartnerCallback::RefreshLicenseComplete.
fLocal
[in] VARIANT_BOOL indicating whether the file is located on the user's computer.
bstrURL
[in] BSTR containing the URL of the file. This is NULL if the content is not local.
type
[in] Streaming type if fLocal is VARIANT_FALSE.
contentID
[in] Content ID of the media file for which the updated license is being requested.
bstrRefreshReason
[in] Reason for refreshing the license. The caller (Windows Media Player) sets this parameter to one of the following values:
g_szRefreshLicensePlay
g_szRefreshLicenseBurn
g_szRefreshLicenseSync
pReasonContext
[in] If refreshing the license for synchronization to a device, this is a VT_BSTR containing device name.
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
This method must not display a user interface.
This method initiates the license update and then returns immediately. When the online store has completed the license update, the online store's plug-in calls IWMPContentPartnerCallback::RefreshLicenseComplete.
Requirements
Version: Windows Media Player 11
Header: contentpartner.h
See Also
Previous | Next |