IWMDRMNetTransmitter::GetRootLicenseResponse method

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The GetRootLicenseResponse method generates a root license response message.

Syntax

HRESULT GetRootLicenseResponse(
  [in]  BSTR  bstrKID,
  [out] BYTE  **ppbLicenseResponse,
  [out] DWORD *pcbLicenseResponse
);

Parameters

bstrKID [in]

Base64-encoded key identifier to be used for the new root license. The key identifier should be a randomly generated GUID value.

ppbLicenseResponse [out]

Address of a variable that receives the address of the generated license response. When finished with this data, you must release the memory by calling CoTaskMemFree.

pcbLicenseResponse [out]

Address of a variable that receives the size of the license response, in bytes.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Remarks

The generated root license is created using the information from the license challenge data, which is processed for the interface by calling SetLicenseChallenge.

The root license is used in the generation of leaf licenses, which is accomplished by calling the GetLeafLicenseResponse method. The IWMDRMNetTransmitter interface maintains a copy of the root license for that use.

The root license created by calling this method does not have any policies and is configured so that it cannot be persisted on the receiving device.

Requirements

See also

IWMDRMNetTransmitter Interface