ホーム › Media.WindowsMediaFormat › IWMLicenseRevocationAgent

IWMLicenseRevocationAgent

COM

IID6967f2c9-4e26-4b57-8894-799880f7ac7b継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWMLicenseRevocationAgent インターフェイスは、DRM ライセンスサーバーからのライセンス失効に関するメッセージを処理します。IWMLicenseRevocationAgent は、ライセンス失効エージェントオブジェクトの主要なインターフェイスです。

解説(Remarks)

ライセンス失効を使用すると、ライセンス発行者はコンピューターからライセンスを削除できます。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetLRBChallenge(BYTE* pMachineID, DWORD dwMachineIDLength, BYTE* pChallenge, DWORD dwChallengeLength, BYTE* pChallengeOutput, DWORD* pdwChallengeOutputLength)

GetLRBChallenge メソッドは、ライセンス失効チャレンジメッセージに対する応答を生成します。アプリケーションはこの応答をライセンスサーバーに送信する必要があります。

pMachineID	BYTE*	in	メモリ内のマシン識別子のアドレスです。マシン識別子の形式は、ライセンスを発行したサービスによって決定されます。
dwMachineIDLength	DWORD	in	マシン識別子のサイズ (バイト単位) です。
pChallenge	BYTE*	in	メモリ内のチャレンジメッセージのアドレスです。このメッセージは、ライセンス発行者によって作成されたコンポーネントが生成します。
dwChallengeLength	DWORD	in	チャレンジメッセージのサイズ (バイト単位) です。
pChallengeOutput	BYTE*	out	チャレンジ応答メッセージを受け取るバッファーのアドレスです。
pdwChallengeOutputLength	DWORD*	out	チャレンジ応答メッセージのサイズ (バイト単位) を受け取る変数のアドレスです。

戻り値

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

ライセンスサーバーは、ユーザー操作の結果としてチャレンジを生成します。この処理は通常、Web コンポーネントによって管理されます。このメソッドを呼び出して生成されたチャレンジ応答は、ライセンスサーバーに送り返す必要があります。

チャレンジと応答が処理された後、ライセンスサーバーは、削除するライセンスに関する指示を含む署名付きのライセンス失効 blob を送信します。ProcessLRB メソッドを呼び出すことで、ライセンスの失効を実行できます。

vtbl 4 HRESULT ProcessLRB(BYTE* pSignedLRB, DWORD dwSignedLRBLength, BYTE* pSignedACK, DWORD* pdwSignedACKLength)

ProcessLRB メソッドは、クライアントコンピューター上のライセンスストアからライセンスを削除します。

pSignedLRB	BYTE*	in	メモリ内の署名付きライセンス失効 blob のアドレスです。この blob は、ライセンスサーバーからアプリケーションに送信されます。
dwSignedLRBLength	DWORD	in	ライセンス失効 blob のサイズ (バイト単位) です。
pSignedACK	BYTE*	out	ライセンス失効の署名付き確認応答を受け取るバッファーのアドレスです。アプリケーションはこの確認応答をライセンスサーバーに送信する必要があります。
pdwSignedACKLength	DWORD*	out	確認応答のサイズ (バイト単位) です。

戻り値

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

ライセンスサーバーは、最初のチャレンジメッセージに対する応答を受信した後、署名付きライセンス失効 blob を送信します。詳細については、GetLRBChallenge を参照してください。

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

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IWMLicenseRevocationAgent "{6967F2C9-4E26-4B57-8894-799880F7AC7B}"
#usecom global IWMLicenseRevocationAgent IID_IWMLicenseRevocationAgent "{}"
#comfunc global IWMLicenseRevocationAgent_GetLRBChallenge  3 var,int,var,int,var,var
#comfunc global IWMLicenseRevocationAgent_ProcessLRB       4 var,int,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IWMLicenseRevocationAgent "{6967F2C9-4E26-4B57-8894-799880F7AC7B}"
#usecom global IWMLicenseRevocationAgent IID_IWMLicenseRevocationAgent "{}"
#comfunc global IWMLicenseRevocationAgent_GetLRBChallenge  3 sptr,int,sptr,int,sptr,sptr
#comfunc global IWMLicenseRevocationAgent_ProcessLRB       4 sptr,int,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。