錯誤處理 (Windows 媒體播放機 SDK)

  • 發行項

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

Windows 媒體播放機 6.4 ActiveX 控制項會在對話方塊和狀態列上顯示錯誤訊息，以提供預設的錯誤處理。 您也可以在腳本中處理錯誤來提供自訂錯誤處理。 錯誤處理是由事件驅動，這表示您會收到每個錯誤的通知，而且必須決定如何在發生錯誤事件時處理每個錯誤事件。 如需使用 6.4 版物件模型處理錯誤的詳細資訊，請參閱版本 6.4 Player 物件模型指南的錯誤處理一節，這是Windows 媒體播放機 SDK 的一部分。

Windows 媒體播放機 7 或更新版本物件模型會提供Error物件和ErrorItem物件來處理錯誤。 這兩個物件會一起運作，以提供錯誤處理機制，讓您能夠完整且彈性地控制錯誤處理常式。 Error物件可讓您存取ErrorItem物件的集合;每個ErrorItem物件都會提供有關個別錯誤訊息的詳細資料。

發生錯誤時，錯誤資訊會張貼至錯誤佇列。 佇列是 ErrorItem 物件的集合。 當每個錯誤新增至佇列時，其會與索引編號相關聯， (從零開始，) 可用來識別特定的 ErrorItem 物件。 錯誤。errorCount屬性會擷取錯誤佇列中的錯誤數目。 由於索引編號是以零起始，所以張貼至佇列的最新錯誤一律會有等於 Error的索引值。errorCount 減一。

您可以使用腳本為Windows 媒體播放機建立錯誤事件處理常式。 下列 JScript 範例示範如何使用 Windows 媒體播放機 7 或更新版本物件模型，從錯誤佇列擷取最新的錯誤專案，以及顯示錯誤碼和錯誤描述。 Player物件是以識別碼 = 「WMP9」 建立。

<!-- Create an error event handler for Windows Media Player 7 or later errors. -->
<SCRIPT  LANGUAGE = "JScript"  FOR = WMP9  EVENT = error()>

// Store the number of errors in the error queue.
var max = WMP9.error.errorCount;

// Retrieve most recent ErrorItem object.
var err = WMP9.error.item(max-1)

// Store the error code number.
var errNum = err.errorCode;

// Store the error description string.
var errDesc = err.errorDescription;

// Build a message string to notify the user.
var msg = "Error number: " + errNum + "\n";
msg += "Error description: " + errDesc;

// Display the message box.
alert(msg);

</SCRIPT>

Error物件有兩個額外的方法可供您使用。 錯誤。clearErrorQueue方法可讓您從錯誤佇列中移除所有錯誤，並將索引編號重設為零。 您可以完全控制此程式;只要您需要這些錯誤可供使用，就可以在佇列中保留錯誤，然後在完成處理錯誤時清空佇列。

錯誤。webHelp方法可讓您使用網際網路向使用者顯示最新的錯誤資訊。 呼叫時，這個方法會將佇列中第一個錯誤的所有相關資訊， (索引為零) 到 Microsoft Windows 媒體播放機 Web 說明，這會在目前的瀏覽器視窗中顯示錯誤的詳細資訊。

Error 物件

ErrorItem 物件

物件模型移轉指南