The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IMFContentEnabler::GetEnableURL method

Retrieves a URL for performing a manual content enabling action.

Syntax

C++


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 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

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