共用方式為

IProgressUI：：ShowErrorDialog 方法

  • 發行項

在Configuration Manager中， 方法會 ShowErrorDialog 在對話方塊中顯示可自訂的錯誤資訊。

語法

[IDL]  
HRESULT ShowErrorDialog(  
     BSTR pszOrgName,  
     BSTR pszTaskSequenceName,  
     BSTR pszCustomTitle,  
     BSTR pszErrorMessage,  
     ULONG uErrorCode,  
     ULONG uTimeoutInSeconds,  
     ULONG uWillReboot,
     BSTR pszTaskSequenceStepName
);

參數

pszOrgName

資料類型：BSTR

限定詞：[in]

進度對話方塊中顯示的組織名稱指標。 您可以從環境變數擷 _SMSTSOrgName 取值。

pszTaskSequenceName

資料類型：BSTR

限定詞：[in]

目前執行中工作順序名稱的指標。 您可以從環境變數擷 _SMSTSPackageName 取值。

pszCustomTitle

資料類型：BSTR

限定詞：[in]

自訂訊息的文字指標，該自訂訊息會取代錯誤對話方塊中顯示的預設標題文字。 如果沒有要顯示的自訂訊息，請傳遞空字串。 此值可以從 _SMSTSCustomProgressDialogMessage 環境變數取得。

pszErrorMessage

資料類型：BSTR

限定詞：[in]

錯誤對話方塊中顯示之自訂訊息文字的指標。 如果沒有要顯示的自訂訊息，請傳遞空字串。 預設文字包含 、 pszTaskSequenceNamepszTaskSequenceStepName 和 uErrorCode 的文字。 它會根據指定的值而變更。

uErrorCode

資料類型：ULONG

限定詞：[in]

最後一個步驟失敗之傳回碼的指標。 此值可以從 _SMSTSLastActionRetCode 環境變數取得。 如果未指定 的 pszErrorMessage 自訂文字， uErrorCode 將會以系統錯誤碼格式Microsoft顯示。

uTimeoutInSeconds

資料類型：ULONG

限定詞：[in]

對話方塊在關閉前顯示之秒數的值指標。 此值可以從 SMSTSErrorDialogTimeout 環境變數取得，此變數預設不會在工作順序中設定。 如果為 uTimeoutInSeconds 指定空字串且 SMSTSErrorDialogTimeout 未指定 ，則會使用預設值 900 秒。

bWillReboot

資料類型：ULONG

限定詞：[in]

Boolean 值。 它會指出當對話方塊關閉或逾時到期時，工作順序是否會重新開機電腦。

pszTaskSequenceStepName

資料類型：BSTR

限定詞：[in]

將顯示在預設 pszErrorMessage 文字中之步驟名稱名稱的文字指標。 您可以從環境變數擷 _SMSTSLastActionName 取值。

傳回值

程式 HRESULT 代碼。 可能的值包括但不限於下列值。 這個方法未傳回任何 HRESULT 特定的值。

S_OK
方法成功。

另請參閱