Win32 API 日本語リファレンス
ホーム › Media.DeviceManager › IMDSPRevoked

IMDSPRevoked

COM
📘 Microsoft Learn (日本語) · English
IIDa4e8f2d4-3f31-464d-b53d-4fc335998184継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IMDSPRevoked インターフェイスは、更新されたコンポーネントをダウンロードできる URL を取得します。このインターフェイスの実装は任意です。詳細については、「Mandatory and Optional Interfaces」を参照してください。

メソッド 1

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

vtbl 3 HRESULT GetRevocationURL(LPWSTR* ppwszRevocationURL, DWORD* pdwBufferLen)

GetRevocationURL メソッドは、更新されたコンポーネントをダウンロードできる URL を取得します。(IMDSPRevoked.GetRevocationURL)

ppwszRevocationURLLPWSTR*inout失効 URL の書き込み先となる Unicode 文字列へのポインター。
pdwBufferLenDWORD*inoutクライアントが提供するバッファーが保持できる WCHAR 文字数。戻り時には、必要な文字数が格納されます。

戻り値

このメソッドは HRESULT を返します。Windows Media Device Manager のすべてのインターフェイスメソッドは、次のいずれかの種類のエラーコードを返す可能性があります。

返される可能性のあるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

IMDSPRevoked インターフェイスは、サービスプロバイダーがいずれかのデジタル著作権管理システムによって失効された場合に、更新されたコンポーネントをダウンロードできる URL を取得します。このメソッドが実装されていない場合は、既定の Microsoft URL が使用されます。この場所は Microsoft によって管理されており、Microsoft のデジタル著作権管理システムによって失効されたコンポーネントの更新プログラムが格納されています。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMDSPRevoked "{A4E8F2D4-3F31-464D-B53D-4FC335998184}"
#usecom global IMDSPRevoked IID_IMDSPRevoked "{}"
#comfunc global IMDSPRevoked_GetRevocationURL  3 var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。