IMFContentEnabler::GetEnableURL method

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

ppwszURL [out]

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

pcchURL [out]

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

pTrustStatus [in, out]

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 codeDescription
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 typePurpose of URL
IndividualizationNot applicable.
License acquisitionURL 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.
RevocationURL to a webpage where the user can download and install an updated component.

 

Requirements

Minimum supported client

Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 [desktop apps | Windows Store apps]

Header

Mfidl.h

Library

Mfuuid.lib

See also

IMFContentEnabler
How to Play Protected Media Files

 

 

Show: