ホーム › Data.RightsManagement › DRMDecrypt

DRMDecrypt

関数

RMSの暗号化プロバイダーでデータを復号する。

DLLmsdrm.dll呼出規約winapi

シグネチャ

// msdrm.dll
#include <windows.h>

HRESULT DRMDecrypt(
    DWORD hCryptoProvider,
    DWORD iPosition,
    DWORD cNumInBytes,
    BYTE* pbInData,
    DWORD* pcNumOutBytes,
    BYTE* pbOutData
);

パラメーター

名前	型	方向	説明
hCryptoProvider	DWORD	in	DRMCreateEnablingBitsDecryptor によって作成された、AD RMS 復号オブジェクトへのハンドル。
iPosition	DWORD	in	復号を開始するバッファー内の位置。0 はバッファー内の最初のブロック、1 は 2 番目のブロックに対応します (以下同様)。このトピックで後述する例を参照してください。
cNumInBytes	DWORD	in	復号するバイト数。
pbInData	BYTE*	inout	復号するバイト列を格納したバッファーへのポインター。
pcNumOutBytes	DWORD*	inout	復号されたデータのサイズ (バイト単位)。
pbOutData	BYTE*	inout	復号されたデータ。

戻り値の型: HRESULT

公式ドキュメント

暗号化されたコンテンツを復号します。

戻り値

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

関数が失敗した場合は、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

解説(Remarks)

復号されたコンテンツのメモリの割り当てと解放は、呼び出し元の関数の責任です。次のコードサンプル (Decrypting Content より) は、コンテンツをブロック単位で復号する方法を示しています。この例では復号するコンテンツのサイズがあらかじめ分かっているため、事前にメモリを割り当てています。ただし、割り当てるバイト数を判別する必要がある場合は、1 回目の呼び出しの後に pcNumOutBytes パラメーターで必要なバッファーサイズが返されます。メモリを割り当て、新しいメモリを指すように pbOutData を設定して関数を再度呼び出してください。

#include "DecryptingContent.h"

/*===================================================================
File:      Decryption_DecryptContent.cpp

THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
PARTICULAR PURPOSE.

Copyright (C) Microsoft.  All rights reserved.
===================================================================*/

/////////////////////////////////////////////////////////////////////
// DecryptContent 関数はコンテンツを復号します。復号対象のコンテンツは、
// このドキュメントで先に示した EncryptingContent の例で作成された
// ものです。
//
HRESULT DecryptContent(
          DRMHANDLE      hBoundLic,
          UINT           uiEncrypted,
          BYTE*          pbEncrypted,
          BYTE**         ppbDecrypted)
{
  HRESULT hr = S_OK;                  // HRESULT の戻り値
  UINT uiBlock = 0;                   // 復号ブロックサイズ (16)
  UINT uiBytes = 0;                   // uiBlock 変数のサイズ (4)
  UINT uiDecrypted = 0;               // 復号されたバイト数
  UINT uiOffset = 0;                  // 復号バッファーのオフセット
  DRMHANDLE hEBDecryptor = NULL;      // 復号オブジェクトのハンドル
  DRMENCODINGTYPE eType;

  wprintf(L"\r\nEntering DecryptContent.\r\n");

  // 入力パラメーターを検証します。
  if ( NULL==hBoundLic ||
       NULL==pbEncrypted ||
       NULL==ppbDecrypted)
       return E_INVALIDARG;

  // 復号オブジェクトを作成します。
  hr = DRMCreateEnablingBitsDecryptor( 
          hBoundLic,                // バインド済みライセンスのハンドル
          L"EDIT",                  // 要求する権利
          NULL,                     // 予約済み
          NULL,                     // 予約済み
          &hEBDecryptor);           // 復号オブジェクトのポインター
  if (FAILED(hr)) goto e_Exit;
  wprintf(L"DRMCreateEnablingBitsDecryptor: hEBDecryptor = %i\r\n",
          hEBDecryptor);

  // DRMDecrypt に渡す必要があるメモリブロックのサイズ (バイト単位) を
  // 取得します。
  uiBytes= sizeof(uiBlock);
  hr = DRMGetInfo(
          hEBDecryptor,               // 復号オブジェクトのハンドル
          g_wszQUERY_BLOCKSIZE,       // クエリする属性
          &eType,                     // 適用するエンコードの種類
          &uiBytes,                   // uiBlock 変数のサイズ
          (BYTE*)&uiBlock);           // メモリブロックのサイズ
  if(FAILED(hr)) goto e_Exit;
  wprintf(L"DRMGetInfo: uiBlock = %u\r\n", uiBlock);

  // 復号されたコンテンツ用のメモリを割り当てます。
  // 注: この例では、復号されたコンテンツを格納するために、サイズが
  //     既知のバッファーを使用しています。ただし通常は、コンテンツを
  //     格納するバッファーは、DRMDecrypt の 1 回目の呼び出しで返された
  //     サイズに基づいて割り当てる必要があります。
  *ppbDecrypted = new BYTE[uiEncrypted];
  if (NULL == *ppbDecrypted)
  {
    hr = E_OUTOFMEMORY;
    goto e_Exit;
  }

  // コンテンツを復号します。
  for ( int j = 0; (UINT)j * uiBlock < uiEncrypted; j++ )
  {
    hr = DRMDecrypt( 
          hEBDecryptor,               // 復号オブジェクトのハンドル
          j * uiBlock,                // バッファー内の位置
          uiBlock,                    // 復号するバイト数
          pbEncrypted + (j*uiBlock),  // 復号するバイト列
          &uiDecrypted,               // 復号されたバイト数
          NULL);                      // 1 回目の呼び出しでは NULL を指定
    if(FAILED(hr)) goto e_Exit;

    hr = DRMDecrypt( 
          hEBDecryptor,               // 復号オブジェクトのハンドル
          j * uiBlock,                // バッファー内の位置 
          uiBlock,                    // 復号するバイト数
          pbEncrypted + (j*uiBlock),  // 復号するバイト列
          &uiDecrypted,               // 復号されたバイト数
          *ppbDecrypted + uiOffset);  // 復号されたデータ
    if(FAILED(hr)) goto e_Exit;

    uiOffset += uiDecrypted;          // バッファーのオフセットを加算します
  }

e_Exit:

  if (NULL != hEBDecryptor)
  {
    hr = DRMCloseHandle(hEBDecryptor);
    hEBDecryptor = NULL;
  }
  
  wprintf(L"Leaving DecryptContent: hr = %x\r\n", hr);
  return hr;
}

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// msdrm.dll
#include <windows.h>

HRESULT DRMDecrypt(
    DWORD hCryptoProvider,
    DWORD iPosition,
    DWORD cNumInBytes,
    BYTE* pbInData,
    DWORD* pcNumOutBytes,
    BYTE* pbOutData
);

[DllImport("msdrm.dll", ExactSpelling = true)]
static extern int DRMDecrypt(
    uint hCryptoProvider,   // DWORD
    uint iPosition,   // DWORD
    uint cNumInBytes,   // DWORD
    IntPtr pbInData,   // BYTE* in/out
    ref uint pcNumOutBytes,   // DWORD* in/out
    IntPtr pbOutData   // BYTE* in/out
);

<DllImport("msdrm.dll", ExactSpelling:=True)>
Public Shared Function DRMDecrypt(
    hCryptoProvider As UInteger,   ' DWORD
    iPosition As UInteger,   ' DWORD
    cNumInBytes As UInteger,   ' DWORD
    pbInData As IntPtr,   ' BYTE* in/out
    ByRef pcNumOutBytes As UInteger,   ' DWORD* in/out
    pbOutData As IntPtr   ' BYTE* in/out
) As Integer
End Function

' hCryptoProvider : DWORD
' iPosition : DWORD
' cNumInBytes : DWORD
' pbInData : BYTE* in/out
' pcNumOutBytes : DWORD* in/out
' pbOutData : BYTE* in/out
Declare PtrSafe Function DRMDecrypt Lib "msdrm" ( _
    ByVal hCryptoProvider As Long, _
    ByVal iPosition As Long, _
    ByVal cNumInBytes As Long, _
    ByVal pbInData As LongPtr, _
    ByRef pcNumOutBytes As Long, _
    ByVal pbOutData As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

DRMDecrypt = ctypes.windll.msdrm.DRMDecrypt
DRMDecrypt.restype = ctypes.c_int
DRMDecrypt.argtypes = [
    wintypes.DWORD,  # hCryptoProvider : DWORD
    wintypes.DWORD,  # iPosition : DWORD
    wintypes.DWORD,  # cNumInBytes : DWORD
    ctypes.POINTER(ctypes.c_ubyte),  # pbInData : BYTE* in/out
    ctypes.POINTER(wintypes.DWORD),  # pcNumOutBytes : DWORD* in/out
    ctypes.POINTER(ctypes.c_ubyte),  # pbOutData : BYTE* in/out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('msdrm.dll')
DRMDecrypt = Fiddle::Function.new(
  lib['DRMDecrypt'],
  [
    -Fiddle::TYPE_INT,  # hCryptoProvider : DWORD
    -Fiddle::TYPE_INT,  # iPosition : DWORD
    -Fiddle::TYPE_INT,  # cNumInBytes : DWORD
    Fiddle::TYPE_VOIDP,  # pbInData : BYTE* in/out
    Fiddle::TYPE_VOIDP,  # pcNumOutBytes : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # pbOutData : BYTE* in/out
  ],
  Fiddle::TYPE_INT)

#[link(name = "msdrm")]
extern "system" {
    fn DRMDecrypt(
        hCryptoProvider: u32,  // DWORD
        iPosition: u32,  // DWORD
        cNumInBytes: u32,  // DWORD
        pbInData: *mut u8,  // BYTE* in/out
        pcNumOutBytes: *mut u32,  // DWORD* in/out
        pbOutData: *mut u8  // BYTE* in/out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("msdrm.dll")]
public static extern int DRMDecrypt(uint hCryptoProvider, uint iPosition, uint cNumInBytes, IntPtr pbInData, ref uint pcNumOutBytes, IntPtr pbOutData);
"@
$api = Add-Type -MemberDefinition $sig -Name 'msdrm_DRMDecrypt' -Namespace Win32 -PassThru
# $api::DRMDecrypt(hCryptoProvider, iPosition, cNumInBytes, pbInData, pcNumOutBytes, pbOutData)

#uselib "msdrm.dll"
#func global DRMDecrypt "DRMDecrypt" sptr, sptr, sptr, sptr, sptr, sptr
; DRMDecrypt hCryptoProvider, iPosition, cNumInBytes, varptr(pbInData), varptr(pcNumOutBytes), varptr(pbOutData)   ; 戻り値は stat
; hCryptoProvider : DWORD -> "sptr"
; iPosition : DWORD -> "sptr"
; cNumInBytes : DWORD -> "sptr"
; pbInData : BYTE* in/out -> "sptr"
; pcNumOutBytes : DWORD* in/out -> "sptr"
; pbOutData : BYTE* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "msdrm.dll"
#cfunc global DRMDecrypt "DRMDecrypt" int, int, int, var, var, var
; res = DRMDecrypt(hCryptoProvider, iPosition, cNumInBytes, pbInData, pcNumOutBytes, pbOutData)
; hCryptoProvider : DWORD -> "int"
; iPosition : DWORD -> "int"
; cNumInBytes : DWORD -> "int"
; pbInData : BYTE* in/out -> "var"
; pcNumOutBytes : DWORD* in/out -> "var"
; pbOutData : BYTE* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "msdrm.dll"
#cfunc global DRMDecrypt "DRMDecrypt" int, int, int, sptr, sptr, sptr
; res = DRMDecrypt(hCryptoProvider, iPosition, cNumInBytes, varptr(pbInData), varptr(pcNumOutBytes), varptr(pbOutData))
; hCryptoProvider : DWORD -> "int"
; iPosition : DWORD -> "int"
; cNumInBytes : DWORD -> "int"
; pbInData : BYTE* in/out -> "sptr"
; pcNumOutBytes : DWORD* in/out -> "sptr"
; pbOutData : BYTE* in/out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。