[利用 所公開功能的 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 中公開的功能。]
DRMCreateEnablingBitsDecryptor 函式會建立解密物件，用來解密內容數據。
語法
DRMEXPORT HRESULT UDAPICALL DRMCreateEnablingBitsDecryptor(
[in] DRMHANDLE hBoundLicense,
[in, optional] PWSTR wszRight,
[in] DRMHANDLE hAuxLib,
[in, optional] PWSTR wszAuxPlug,
[out] DRMHANDLE *phDecryptor
);
參數
[in] hBoundLicense
使用 DRMCreateBoundLicense所建立之系結授權物件的句柄。
[in, optional] wszRight
選擇性的 Null 終止字串，其中包含練習的權利。 解密物件一次只能系結至一個許可權。
[in] hAuxLib
保留供未來使用。 此參數必須是 NULL。
[in, optional] wszAuxPlug
保留供未來使用。 此參數必須是 NULL。
[out] phDecryptor
解密物件的指標。
傳回值
如果函式成功，函式會傳回S_OK。
如果函式失敗，它會傳回 指出錯誤的 HRESULT 值。 可能的值包括但不限於下列清單中的值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。
備註
取用應用程式會執行下列步驟，以解密先前由發行應用程式加密的內容。
- 擷取用戶授權。 呼叫 DRMEnumerateLicense 以擷取已存在於存放區中的授權。 如果函式成功，請移至步驟 2。 如果授權不在市集中，請呼叫 DRMAcquireLicense ，後面接著 DRMEnumerateLicense。
- 呼叫 DRMCreateBoundLicense 以建立系結至用戶授權中一或多個許可權的授權。 系結授權包含可用於解密的對稱金鑰。
- 呼叫 DRMCreateEnablingBitsDecryptor 以建立與系結許可權和內容密鑰相關聯的解密物件。
- 呼叫 DRMDecrypt 以使用內容密鑰來解密內容。
當您完成解密物件句柄時，請呼叫 DRMCloseHandle 函式來關閉解密物件句柄。 解密物件句柄和系結的授權句柄都必須保持開啟狀態，直到解密完成為止。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | msdrm.h |
| 程式庫 | Msdrm.lib |
| Dll | Msdrm.dll |