Share via


IWMDRMSecurity::GetMachineCertificate 方法

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

GetMachineCertificate方法會擷取用戶端電腦上 DRM 子系統的電腦憑證。

語法

HRESULT GetMachineCertificate(
  [in]      DWORD dwCertificateType,
  [out]     BYTE  rgbVersion[4],
  [out]     BYTE  **ppbCertificate,
  [in, out] DWORD *pcbCertificate
);

參數

dwCertificateType [in]

要擷取的憑證類型。 設定為下表中的其中一個值。

描述
WMDRM_CERTIFICATE_TYPE_V1 憑證會以舊版元件所使用的格式擷取。
WMDRM_CERTIFICATE_TYPE_V2 憑證會以 Windows Vista 元件所使用的格式擷取。

rgbVersion[4] [out]

指定用戶端電腦上 DRM 子系統版本的四個位元組陣列。

ppbCertificate [out]

接收憑證資料指標的變數位址。 設定為 Null ,讓 方法提供在 sslCertificate中保存憑證所需的緩衝區大小。

sslCertificate [in, out]

以位元組為單位的憑證大小。 如果 ppbCertificateNull,此值將會設定為憑證的大小。 如果 ppbCertificate 不是 Null,此值必須設定為緩衝區的大小。

傳回值

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

傳回碼 描述
S_OK
此方法已成功。

規格需求

需求
標頭
Wmdrmsdk.h
程式庫
Wmdrmsdk.lib

另請參閱

IWMDRMSecurity 介面