IWMDRMNetTransmitter：：GetRootLicenseResponse 方法

[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器和接收寫入器已取代它。 來源讀取器和接收寫入器已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用來源讀取器和接收寫入器，而不是Windows 媒體格式 11 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

GetRootLicenseResponse方法會產生根授權回應訊息。

語法

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

參數

bstrKID [in]

要用於新根授權的 Base64 編碼金鑰識別碼。 金鑰識別碼應該是隨機產生的 GUID 值。

ppbLicenseResponse [out]

接收所產生授權回應位址的變數位址。 完成此資料之後，您必須呼叫 CoTaskMemFree來釋放記憶體。

dnsLicenseResponse [out]

接收授權回應大小的變數位址，以位元組為單位。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
NS_E_DRM_RIV_TOO_SMALL	需要更新的內容撤銷清單。
S_OK	此方法已成功。

備註

產生的根授權是使用來自授權挑戰資料的資訊所建立，此資料會藉由呼叫 SetLicenseChallenge來處理介面。

根授權用於產生分葉授權，這是藉由呼叫 GetLeafLicenseResponse 方法來完成的。 IWMDRMNetTransmitter介面會維護該用途的根授權複本。

呼叫此方法所建立的根授權沒有任何原則，而且已設定，使其無法保存在接收裝置上。

規格需求

需求	值
標頭	Wmdrmsdk.h

另請參閱

IWMDRMNetTransmitter 介面