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

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 物件

物件模型移轉指南