DRMCreateEnablingBitsEncryptor 函式 (msdrm.h)

[利用所公開功能的 AD RMS SDK

Msdrm.dll 中的用戶端可用於 Windows Server 2008、Windows Vista、Windows Server 2008 R2、Windows 7、Windows Server 2012 和 Windows 8。它可能會改變或

後續版本無法使用。請改用 Active Directory Rights Management Services SDK 2.1、

會利用用戶端在 Msipc.dll 中公開的功能。

DRMCreateEnablingBitsEncryptor函式會建立用來加密內容資料的 AD RMS 加密物件。

語法

DRMEXPORT HRESULT UDAPICALL DRMCreateEnablingBitsEncryptor(
  [in]           DRMHANDLE hBoundLicense,
  [in, optional] PWSTR     wszRight,
  [in]           DRMHANDLE hAuxLib,
  [in, optional] PWSTR     wszAuxPlug,
  [out]          DRMHANDLE *phEncryptor
);

參數

[in] hBoundLicense

DRMCreateBoundLicense所產生的系結授權控制碼。

[in, optional] wszRight

選擇性的 Null 終止字串，其中包含右方。如果您指定 Null，AD RMS 加密物件會系結至授權中的第一個有效許可權。

[in] hAuxLib

保留供未來使用。此參數必須是 Null。

[in, optional] wszAuxPlug

保留供未來使用。此參數必須是 Null。

[out] phEncryptor

加密物件的指標。

傳回值

如果函式成功，函式會傳回S_OK。

如果函式失敗，它會傳回 HRESULT 值，指出錯誤。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

備註

執行下列步驟來加密內容。如需詳細資訊，請參閱加密內容。

取得使用者授權。如果您用於此用途的發行授權已在線上簽署，請呼叫 DRMAcquireLicense ，後面接著 DRMEnumerateLicense。如果發行授權已離線簽署，請改為呼叫 DRMGetOwnerLicense 。
呼叫 DRMCreateBoundLicense 以建立系結至使用者授權中編輯或擁有者許可權的授權。系結授權包含可用於加密的對稱金鑰。
呼叫 DRMCreateEnablingBitsEncryptor ，以建立與系結許可權和內容金鑰相關聯的加密物件。
呼叫 DRMEncrypt 以使用內容金鑰來加密內容。

呼叫 DRMCloseHandle 函式，以在完成加密物件控制碼時關閉加密物件控制碼。加密物件控制碼和系結授權控制碼都必須保持開啟狀態，直到加密完成為止。