DRMCreateEnablingBitsDecryptor 関数 (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 でクライアントによって公開される機能を活用します。

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 で終わる省略可能な文字列。 復号化オブジェクトは、一度に 1 つの権限にのみバインドできます。

[in] hAuxLib

将来利用するために予約されています。 このパラメーターは NULL である必要があります。

[in, optional] wszAuxPlug

将来利用するために予約されています。 このパラメーターは NULL である必要があります。

[out] phDecryptor

復号化オブジェクトへのポインター。

戻り値

関数が成功した場合、関数はS_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 使用できる値には、次の一覧の値が含まれますが、これらに限定されません。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

注釈

使用しているアプリケーションは、以前に発行アプリケーションによって暗号化されたコンテンツを復号化するために、次の手順を実行します。

  1. エンドユーザー ライセンスを取得します。 DRMEnumerateLicense を呼び出して、ストアに既に存在するライセンスを取得します。 関数が成功した場合は、手順 2 に進みます。 ライセンスがストアにない場合は、 DRMAcquireLicense を呼び出し、 DRMEnumerateLicense を呼び出します。
  2. DRMCreateBoundLicense を呼び出して、エンド ユーザー ライセンスの 1 つ以上の権限にバインドするライセンスを作成します。 バインドされたライセンスには、暗号化解除に使用できる対称キーが含まれています。
  3. DRMCreateEnablingBitsDecryptor を呼び出して、バインドされた右キーとコンテンツ キーに関連付けられた復号化オブジェクトを作成します。
  4. DRMDecrypt を呼び出して、コンテンツ キーを使用してコンテンツの暗号化を解除します。

DRMCloseHandle 関数を呼び出して、処理が完了したら復号化オブジェクト ハンドルを閉じます。 暗号化解除オブジェクト ハンドルとバインドされたライセンス ハンドルは、暗号化解除が完了するまで開いたままにする必要があります。

要件

要件 値
対象プラットフォーム Windows
ヘッダー msdrm.h
Library Msdrm.lib
[DLL] Msdrm.dll

こちらもご覧ください

AD RMS 関数

DRMCreateEnablingBitsEncryptor

コンテンツの暗号化解除

  • Last updated on