Sdílet prostřednictvím

Metoda IProgressUI::ShowErrorDialog

  • Článek

V Configuration Manager ShowErrorDialog metoda zobrazí v dialogovém okně přizpůsobitelné informace o chybě.

Syntaxe

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

Parametry

pszOrgName

Datový typ: BSTR

Kvalifikátory: [v]

Ukazatel na název organizace, který se zobrazí v dialogovém okně průběhu. Hodnotu je možné načíst z _SMSTSOrgName proměnné prostředí.

pszTaskSequenceName

Datový typ: BSTR

Kvalifikátory: [v]

Ukazatel na název aktuálně spuštěného pořadí úkolů. Hodnotu je možné načíst z _SMSTSPackageName proměnné prostředí.

pszCustomTitle

Datový typ: BSTR

Kvalifikátory: [v]

Ukazatel myši na text vlastní zprávy, který nahrazuje výchozí text nadpisu zobrazený v dialogovém okně chyby. Pokud neexistuje žádná vlastní zpráva, která by se zobrazila, předejte prázdný řetězec. Hodnotu lze získat z _SMSTSCustomProgressDialogMessage proměnné prostředí.

pszErrorMessage

Datový typ: BSTR

Kvalifikátory: [v]

Ukazatel myši na text vlastní zprávy, který se zobrazí v dialogovém okně chyby. Pokud neexistuje žádná vlastní zpráva, která by se zobrazila, předejte prázdný řetězec. Výchozí text obsahuje text z pszTaskSequenceName, pszTaskSequenceStepNamea uErrorCode. Mění se v závislosti na zadaných hodnotách.

uErrorCode

Datový typ: ULONG

Kvalifikátory: [v]

Ukazatel na návratový kód posledního kroku, který selhal. Hodnotu lze získat z _SMSTSLastActionRetCode proměnné prostředí. Pokud není zadán žádný vlastní text propszErrorMessage, uErrorCode zobrazí se ve formátu Microsoft kódu chyby systému.

uTimeoutInSeconds

Datový typ: ULONG

Kvalifikátory: [v]

Ukazatel na hodnotu pro počet sekund zobrazeného dialogového okna před zavřením. Hodnotu je možné získat z SMSTSErrorDialogTimeout proměnné prostředí, která není ve výchozím nastavení nakonfigurovaná v pořadí úkolů. Pokud je pro uTimeoutInSeconds zadaný prázdný řetězec a SMSTSErrorDialogTimeout není zadaný, použije se výchozí hodnota 900 sekund.

bWillReboot

Datový typ: ULONG

Kvalifikátory: [v]

Logická hodnota. Určuje, jestli pořadí úkolů restartuje počítač, když je dialogové okno zavřené nebo vyprší časový limit.

pszTaskSequenceStepName

Datový typ: BSTR

Kvalifikátory: [v]

Ukazatel na text pro název názvu kroku, který se zobrazí ve výchozím pszErrorMessage textu. Hodnotu je možné načíst z _SMSTSLastActionName proměnné prostředí.

Návratové hodnoty

Kód HRESULT . Mezi možné hodnoty patří mimo jiné následující hodnota. Nejsou vráceny žádné HRESULT hodnoty, které jsou specifické pro tuto metodu.

S_OK
Metoda byla úspěšná.

Viz také