ホーム › Media.MediaPlayer › IWMPError

IWMPError

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDa12dcf7d-14ab-4c1b-a8cd-63909f06025b継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

IWMPError インターフェイスは、IWMPErrorItem ポインターのコレクションにアクセスするためのメソッドを提供します。

メソッド 4

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT clearErrorQueue()

clearErrorQueue メソッドは、エラーキューからエラーをクリアします。

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。

解説(Remarks)

一連のエラーの処理が完了した後にエラーキューをクリアするには、このメソッドを使用します。

カスタムのエラーメッセージを表示する場合は、VARIANT_BOOL を FALSE に設定し、それを IWMPSettings::put_enableErrorDialogs に渡してください。

vtbl 8 HRESULT get_errorCount(INT* plNumErrors)

get_errorCount メソッドは、エラーキュー内のエラー数を取得します。

plNumErrors

INT*

inout

エラー数を格納する long へのポインター。

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。

解説(Remarks)

カスタムのエラーメッセージを表示する場合は、VARIANT_BOOL を FALSE に設定し、それを IWMPSettings::put_enableErrorDialogs に渡してください。

vtbl 9 HRESULT get_item(INT dwIndex, IWMPErrorItem** ppErrorItem)

get_item メソッドは、エラーキューから IWMPErrorItem インターフェイスへのポインターを取得します。

dwIndex	INT	in	IWMPErrorItem インターフェイスへのポインターのインデックスを格納する long。
ppErrorItem	IWMPErrorItem**	out	IWMPErrorItem インターフェイスへのポインターへのポインター。

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。

解説(Remarks)

Windows Media Player は、エラー状態に応じて複数のエラーを生成することがあります。このメソッドは、インデックス番号を使用してキュー内の特定のエラーを取得します。エラーキューのインデックス番号は 0 から始まります。

カスタムのエラーメッセージを表示する場合は、VARIANT_BOOL を FALSE に設定し、それを IWMPSettings::put_enableErrorDialogs に渡してください。

vtbl 10 HRESULT webHelp()

webHelp メソッドは、Windows Media Player の Web ヘルプページを起動し、エラーキュー内の最初のエラー(インデックス 0)に関する詳細情報を表示します。

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。

解説(Remarks)

Web ヘルプページには、Windows Media Player のエラーに関する最新かつ最も詳細な情報が常に掲載されています。このメソッドは、使用しているオペレーティングシステムのバージョンなど、Web ヘルプが必要とするその他の情報を自動的に転送します。

Web ヘルプページに直接アクセスするには、次のエラーコードおよびサポートセンターのリンクを使用してください。

Windows Media Player 10 Mobile: このメソッドは常に S_OK を返しますが、Windows Media Player の Web ヘルプページは起動しません。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IWMPError "{A12DCF7D-14AB-4C1B-A8CD-63909F06025B}"
#usecom global IWMPError IID_IWMPError "{}"
#comfunc global IWMPError_clearErrorQueue  7
#comfunc global IWMPError_get_errorCount   8 var
#comfunc global IWMPError_get_item         9 int,sptr
#comfunc global IWMPError_webHelp          10
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IWMPError "{A12DCF7D-14AB-4C1B-A8CD-63909F06025B}"
#usecom global IWMPError IID_IWMPError "{}"
#comfunc global IWMPError_clearErrorQueue  7
#comfunc global IWMPError_get_errorCount   8 sptr
#comfunc global IWMPError_get_item         9 int,sptr
#comfunc global IWMPError_webHelp          10
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。