IMFContentEnabler::GetEnableURL method (mfidl.h)

Retrieves a URL for performing a manual content enabling action.

Syntax

HRESULT GetEnableURL(
  [out]     LPWSTR              *ppwszURL,
  [out]     DWORD               *pcchURL,
  [in, out] MF_URL_TRUST_STATUS *pTrustStatus
);

Parameters

[out] ppwszURL

Receives a pointer to a buffer that contains the URL. The caller must release the memory for the buffer by calling CoTaskMemFree.

[out] pcchURL

Receives the number of characters returned in ppwszURL, including the terminating NULL character.

[in, out] pTrustStatus

Receives a member of the MF_URL_TRUST_STATUS enumeration indicating whether the URL is trusted.

Return value

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.
MF_E_NOT_AVAILABLE
No URL is available.

Remarks

If the enabling action can be performed by navigating to a URL, this method returns the URL. If no such URL exists, the method returns a failure code.

The purpose of the URL depends on the content enabler type, which is obtained by calling IMFContentEnabler::GetEnableType.

Enable type Purpose of URL
Individualization Not applicable.
License acquisition URL to obtain the license. Call IMFContentEnabler::GetEnableData and submit the data to the URL as an HTTP POST request. To receive notification when the license is acquired, call IMFContentEnabler::MonitorEnable.
Revocation URL to a webpage where the user can download and install an updated component.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

How to Play Protected Media Files

IMFContentEnabler