Error.item メソッド

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 可能な場合は、新しいコードで SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

item メソッドは、エラー キューから ErrorItem オブジェクトを取得します。

構文

retVal = Error.item(
  index
)

パラメーター

index [in]

取得する ErrorItem オブジェクトのインデックスを含む数値 (long)。

戻り値

このメソッドは ErrorItem オブジェクトを返します。

解説

Windows メディア プレーヤーは、エラー状態に応じて多数のエラーを生成できます。 このメソッドを使用すると、インデックス番号を使用してキュー内の特定のエラーを取得できます。 エラー キューのインデックス番号は 0 から始まります。

[設定] を設定する必要があります。カスタム エラー メッセージを表示する場合は、enableErrorDialogs を false に設定します。

例

次の JScript の例では 、Error を使用します。イベント ハンドラー内の item オブジェクトを使用して、ユーザーに最新のエラーを通知します。 Player オブジェクトは ID = "Player" で作成されました。

<SCRIPT LANGUAGE="JScript"  FOR=Player EVENT=error()>

// Store the most recent error item number.
var max = Player.error.errorCount - 1 

// Store the most recent error in an error item object.
var errItem = Player.error.item(max);

// Use the error item object to store the error info.
errDesc = errItem.errorDescription;
errNum = errItem.errorCode;

// Display the error info.
alert(errNum + "\n" + errDesc);

</SCRIPT>

要件

要件 値
Version
 バージョン 7.0 以降をWindows メディア プレーヤーします。
[DLL]
Wmp.dll

関連項目

Error オブジェクト

ErrorItem オブジェクト