ホーム › Media.DeviceManager › ISCPSecureQuery2
ISCPSecureQuery2
COM公式ドキュメント
ISCPSecureQuery2 インターフェイスは、セキュアコンテンツプロバイダーがそのコンテンツを担当するかどうかを判定し、担当する場合には失効したコンポーネントを更新するための URL を提供し、どのコンポーネントが失効しているかを判定する機能によって ISCPSecureQuery を拡張します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 7 HRESULT MakeDecision2(DWORD fuFlags, BYTE* pData, DWORD dwSize, DWORD dwAppSec, BYTE* pbSPSessionKey, DWORD dwSessionKeyLen, IMDSPStorageGlobals* pStorageGlobals, BYTE* pAppCertApp, DWORD dwAppCertAppLen, BYTE* pAppCertSP, DWORD dwAppCertSPLen, LPWSTR* pszRevocationURL, DWORD* pdwRevocationURLLen, DWORD* pdwRevocationBitFlag, ULONGLONG* pqwFileSize, IUnknown* pUnknown, ISCPSecureExchange** ppExchange, BYTE* abMac)
MakeDecision2 メソッドは、Windows Media Device Manager がこのメソッドに渡すデータを調べることによって、セキュアコンテンツプロバイダーがそのコンテンツを担当するかどうかを判定します。
| fuFlags | DWORD | in | 判定を行うためにセキュアコンテンツプロバイダーに提供されるデータを示すフラグです。このパラメーターは入力メッセージ認証コードに含める必要があります。次のフラグの 1 つ以上をビットごとの OR で組み合わせることができます。
| ||||||||||
| pData | BYTE* | in | 調査対象のデータを格納したデータオブジェクトへのポインターです。このパラメーターは入力メッセージ認証コードに含める必要があり、暗号化されている必要があります。 | ||||||||||
| dwSize | DWORD | in | ファイルデータのサイズを格納する DWORD です。 | ||||||||||
| dwAppSec | DWORD | in | 調査対象のサービスプロバイダーおよびセキュアコンテンツプロバイダーの WMDMRIGHTS 構造体の dwAppSec メンバーの長さ (バイト単位) を格納する DWORD です。このパラメーターは入力メッセージ認証コードに含める必要があります。 | ||||||||||
| pbSPSessionKey | BYTE* | in | pStgGlobals が指すサービスプロバイダーとの通信を保護するためのセッションキーを格納するバイト配列へのポインターです。このパラメーターは入力メッセージ認証コードに含める必要があり、暗号化されている必要があります。 | ||||||||||
| dwSessionKeyLen | DWORD | in | セッションキーの長さを格納する DWORD です。 | ||||||||||
| pStorageGlobals | IMDSPStorageGlobals* | inoptional | ファイルの転送元または転送先となるメディアまたはデバイスのルートストレージ上の IWMDMStorageGlobals インターフェイスへのポインターです。このパラメーターは入力メッセージ認証コードに含める必要があります。 | ||||||||||
| pAppCertApp | BYTE* | in | アプリケーションオブジェクトのアプリケーション証明書へのポインターです。 | ||||||||||
| dwAppCertAppLen | DWORD | in | アプリケーション証明書の長さ (バイト単位) を格納する DWORD です。 | ||||||||||
| pAppCertSP | BYTE* | in | サービスプロバイダーオブジェクトのアプリケーション証明書へのポインターです。 | ||||||||||
| dwAppCertSPLen | DWORD | in | アプリケーション証明書の長さ (バイト単位) を格納する DWORD です。 | ||||||||||
| pszRevocationURL | LPWSTR* | inout | 失効 URL を格納するバッファーへのポインターです。 | ||||||||||
| pdwRevocationURLLen | DWORD* | inout | rpszRevocationURL バッファーのサイズ (バイト単位) を格納する DWORD へのポインターです。 | ||||||||||
| pdwRevocationBitFlag | DWORD* | out | 失効ビットフラグを格納する DWORD へのポインターです。フラグの値は 0 になるか、次のフラグ名の 1 つ以上をビットごとの OR で組み合わせた値になります。
| ||||||||||
| pqwFileSize | ULONGLONG* | inoutoptional | ファイルサイズを格納する QWORD へのポインターです。セキュアコンテンツプロバイダーは、この値を更新する責任があります。この時点で転送先ファイルのサイズを判断できない場合は 0 に設定します。 | ||||||||||
| pUnknown | IUnknown* | inoptional | アプリケーションからの不明なインターフェイスへのポインターです。 | ||||||||||
| ppExchange | ISCPSecureExchange** | out | 交換インターフェイスを受け取る交換オブジェクトへのポインターです。 | ||||||||||
| abMac | BYTE* | inout | このメソッドのパラメーターデータに対するメッセージ認証コードを格納する 8 バイトの配列です (WMDM_MAC_LENGTH は 8 として定義されています)。 |
戻り値
メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。
| 戻り値 | 説明 |
|---|---|
| セキュアコンテンツプロバイダーが DRM クライアントとの通信に使用するアプリケーション証明書が失効しています。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_ISCPSecureQuery2 "{EBE17E25-4FD7-4632-AF46-6D93D4FCC72E}" #usecom global ISCPSecureQuery2 IID_ISCPSecureQuery2 "{}" #comfunc global ISCPSecureQuery2_MakeDecision2 7 int,var,int,int,var,int,sptr,var,int,var,int,var,var,var,var,sptr,sptr,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ISCPSecureQuery2 "{EBE17E25-4FD7-4632-AF46-6D93D4FCC72E}" #usecom global ISCPSecureQuery2 IID_ISCPSecureQuery2 "{}" #comfunc global ISCPSecureQuery2_MakeDecision2 7 int,sptr,int,int,sptr,int,sptr,sptr,int,sptr,int,sptr,sptr,sptr,sptr,sptr,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。