ホーム › Media.DeviceManager › ISCPSecureQuery3
ISCPSecureQuery3
COM公式ドキュメント
ISCPSecureQuery3 インターフェイスは ISCPSecureQuery2 を拡張し、クリアチャネル上で権利を取得して判定を行うための新しいメソッド群を提供します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 8 HRESULT GetRightsOnClearChannel(BYTE* pData, DWORD dwSize, BYTE* pbSPSessionKey, DWORD dwSessionKeyLen, IMDSPStorageGlobals* pStgGlobals, IWMDMProgress3* pProgressCallback, WMDMRIGHTS** ppRights, DWORD* pnRightsCount)
GetRightsOnClearChannel メソッドは、クリアチャネル上で現在のコンテンツに関する権利情報を取得します。
| pData | BYTE* | in | データオブジェクトへのポインター。 |
| dwSize | DWORD | in | pData バッファー内のデータのバイト数。 |
| pbSPSessionKey | BYTE* | in | pStgGlobals が指すサービスプロバイダーとの通信を保護するためのセッションキーを格納したバイト配列へのポインター。 |
| dwSessionKeyLen | DWORD | in | pbSPSessionKey が指すバイト配列の長さ。 |
| pStgGlobals | IMDSPStorageGlobals* | inoptional | ファイルの転送元または転送先となるメディアまたはデバイスのルートストレージ上の IWMDMStorageGlobals インターフェイスへのポインター。 |
| pProgressCallback | IWMDMProgress3* | inoptional | IWMDMProgress3 インターフェイスへのポインター。 |
| ppRights | WMDMRIGHTS** | out | このオブジェクトの権利情報を格納した WMDMRIGHTS 構造体の配列へのポインター。この配列は本メソッドによって割り当てられるため、CoTaskMemFree を使用して解放する必要があります。 |
| pnRightsCount | DWORD* | out | ppRights 配列内の WMDMRIGHTS 構造体の数。 |
戻り値
メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。
| 戻り値 | 説明 |
|---|---|
| このメソッドが正しくない順序で呼び出されました。ISCPSecureQuery::GetDataDemands、続いて ISCPSecureQuery::ExamineData をこの順序で呼び出す必要があります。 | |
| メッセージ認証コードが無効です。 | |
| 呼び出し元は、要求された操作を実行するために必要な権利を持っていません。 | |
| パラメーターが無効か、NULL ポインターです。 | |
| 不明なエラーが発生しました。 |
解説(Remarks)
このメソッドは ISCPSecureQuery::GetRights と同一ですが、本メソッドに渡されるパラメーターが暗号化されない点が異なります。そのため、本メソッドの方が効率的です。
vtbl 9 HRESULT MakeDecisionOnClearChannel(DWORD fuFlags, BYTE* pData, DWORD dwSize, DWORD dwAppSec, BYTE* pbSPSessionKey, DWORD dwSessionKeyLen, IMDSPStorageGlobals* pStorageGlobals, IWMDMProgress3* pProgressCallback, BYTE* pAppCertApp, DWORD dwAppCertAppLen, BYTE* pAppCertSP, DWORD dwAppCertSPLen, LPWSTR* pszRevocationURL, DWORD* pdwRevocationURLLen, DWORD* pdwRevocationBitFlag, ULONGLONG* pqwFileSize, IUnknown* pUnknown, ISCPSecureExchange** ppExchange)
MakeDecisionOnClearChannel メソッドは、クリアチャネル上でコンテンツへのアクセスが許可されるかどうかを判定します。アクセスが許可される場合、本メソッドはコンテンツへのアクセスに使用するインターフェイスを返します。
| fuFlags | DWORD | in | 判定を行うためにコンテンツプロバイダーへ提供されるデータを表すフラグ。次のフラグを指定できます。
| ||||||||||
| pData | BYTE* | in | 検査対象のデータを格納したデータオブジェクトへのポインター。 | ||||||||||
| dwSize | DWORD | in | 検査対象データの長さ (バイト単位) を格納する DWORD。 | ||||||||||
| dwAppSec | DWORD | in | Windows Media Device Manager の現在のセキュリティレベルを示す DWORD。これは、アプリケーションと対象のサービスプロバイダーの現在のセキュリティレベルのうち、小さい方の値です。 | ||||||||||
| pbSPSessionKey | BYTE* | in | pStgGlobals が指すサービスプロバイダーとの通信を保護するためのセッションキーを格納したバイト配列へのポインター。 | ||||||||||
| dwSessionKeyLen | DWORD | in | pbSPSessionKey が指すバイト配列の長さ。 | ||||||||||
| pStorageGlobals | IMDSPStorageGlobals* | inoptional | ファイルの転送元または転送先となるメディアまたはデバイスのルートストレージ上の IWMDMStorageGlobals インターフェイスへのポインター。 | ||||||||||
| pProgressCallback | IWMDMProgress3* | inoptional | 進行状況コールバックオブジェクトへのポインター。 | ||||||||||
| 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 | 交換インターフェイスを受け取る交換オブジェクトへのポインター。 |
戻り値
メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。
| 戻り値 | 説明 |
|---|---|
| このメソッドが正しくない順序で呼び出されました。 | |
| メッセージ認証コードが無効です。 | |
| Windows Media Device Manager は、別のデータパケットを指定して本メソッドを再度呼び出す必要があります。パケットのサイズは、ISCPSecureQuery::GetDataDemands メソッドの pdwMinDecisionData パラメーターによって決まります。 | |
| 呼び出し元は、要求された転送を実行するために必要な権利を持っていません。 | |
| パラメーターが無効か、NULL ポインターです。 | |
| 不明なエラーが発生しました。 |
解説(Remarks)
このメソッドは ISCPSecureQuery2::MakeDecision2 と同一ですが、本メソッドに渡されるパラメーターが暗号化されない点が異なります。そのため、本メソッドの方が効率的です。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ISCPSecureQuery3 "{B7EDD1A2-4DAB-484B-B3C5-AD39B8B4C0B1}" #usecom global ISCPSecureQuery3 IID_ISCPSecureQuery3 "{}" #comfunc global ISCPSecureQuery3_GetRightsOnClearChannel 8 var,int,var,int,sptr,sptr,var,var #comfunc global ISCPSecureQuery3_MakeDecisionOnClearChannel 9 int,var,int,int,var,int,sptr,sptr,var,int,var,int,var,var,var,var,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ISCPSecureQuery3 "{B7EDD1A2-4DAB-484B-B3C5-AD39B8B4C0B1}" #usecom global ISCPSecureQuery3 IID_ISCPSecureQuery3 "{}" #comfunc global ISCPSecureQuery3_GetRightsOnClearChannel 8 sptr,int,sptr,int,sptr,sptr,sptr,sptr #comfunc global ISCPSecureQuery3_MakeDecisionOnClearChannel 9 int,sptr,int,int,sptr,int,sptr,sptr,sptr,int,sptr,int,sptr,sptr,sptr,sptr,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。