在 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 方法成功。