次の方法で共有

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]

エラー ダイアログ ボックスに表示されるカスタム メッセージのテキストへのポインター。 表示するカスタム メッセージがない場合は、空の文字列を渡します。 既定のテキストには、、pszTaskSequenceStepName、および uErrorCodeのテキストがpszTaskSequenceName含まれます。 指定された値に応じて変更されます。

uErrorCode

データ型: ULONG

修飾子: [in]

失敗した最後のステップの戻りコードへのポインター。 値は環境変数から _SMSTSLastActionRetCode 取得できます。 のpszErrorMessageカスタム テキストが指定されていない場合は、 uErrorCodeシステム エラー コード形式Microsoft表示されます。

uTimeoutInSeconds

データ型: ULONG

修飾子: [in]

ダイアログ ボックスが閉じる前に表示される秒数の値へのポインター。 この値は、既定ではタスク シーケンスで構成されていない環境変数から SMSTSErrorDialogTimeout 取得できます。 に空の文字列が指定されuTimeoutInSecondsSMSTSErrorDialogTimeout、指定されていない場合は、既定値の 900 秒が使用されます。

bWillReboot

データ型: ULONG

修飾子: [in]

ブール型 (Boolean) の値 ダイアログが閉じられたときにタスク シーケンスがコンピューターを再起動するか、タイムアウトの有効期限が切れるかを示します。

pszTaskSequenceStepName

データ型: BSTR

修飾子: [in]

既定 pszErrorMessage のテキストに表示されるステップ名の名前のテキストへのポインター。 値は環境変数から _SMSTSLastActionName 取得できます。

戻り値

HRESULTコード。 指定できる値には、次の値が含まれますが、これらに限定されません。 このメソッドに固有の値は返されません HRESULT 。

S_OK
メソッドは成功しました。

関連項目