Windows Media Player 11 SDK IWMPContentPartner::RefreshLicense 

  • Article

Windows Media Player SDK banner art

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