Freigeben über

IProgressUI::ShowErrorDialog-Methode

In Configuration Manager zeigt die ShowErrorDialog -Methode anpassbare Fehlerinformationen in einem Dialogfeld an.

Syntax

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

Parameter

pszOrgName

Datentyp: BSTR

Qualifizierer: [in]

Zeiger auf den organization Namen, der im Statusdialogfeld angezeigt wird. Der Wert kann aus der Umgebungsvariablen _SMSTSOrgName abgerufen werden.

pszTaskSequenceName

Datentyp: BSTR

Qualifizierer: [in]

Zeiger auf den Namen der Tasksequenz, die derzeit ausgeführt wird. Der Wert kann aus der Umgebungsvariablen _SMSTSPackageName abgerufen werden.

pszCustomTitle

Datentyp: BSTR

Qualifizierer: [in]

Zeiger auf den Text für eine benutzerdefinierte Nachricht, die den im Fehlerdialogfeld angezeigten Standardtiteltext ersetzt. Übergeben Sie eine leere Zeichenfolge, wenn keine benutzerdefinierte Meldung angezeigt werden soll. Der Wert kann aus der Umgebungsvariablen _SMSTSCustomProgressDialogMessage abgerufen werden.

pszErrorMessage

Datentyp: BSTR

Qualifizierer: [in]

Zeiger auf den Text für die benutzerdefinierte Meldung, die im Fehlerdialogfeld angezeigt wird. Übergeben Sie eine leere Zeichenfolge, wenn keine benutzerdefinierte Meldung angezeigt werden soll. Der Standardtext enthält den Text aus pszTaskSequenceName, pszTaskSequenceStepNameund uErrorCode. Sie ändert sich je nachdem, welche Werte angegeben werden.

uErrorCode

Datentyp: ULONG

Qualifizierer: [in]

Zeiger auf den Rückgabecode des letzten fehlgeschlagenen Schritts. Der Wert kann aus der Umgebungsvariablen _SMSTSLastActionRetCode abgerufen werden. Wenn kein benutzerdefinierter Text für pszErrorMessage angegeben ist, uErrorCode wird im Microsoft-Systemfehlercodeformat angezeigt.

uTimeoutInSeconds

Datentyp: ULONG

Qualifizierer: [in]

Zeiger auf den Wert für die Anzahl der Sekunden, die das Dialogfeld vor dem Schließen angezeigt wird. Der Wert kann aus der SMSTSErrorDialogTimeout Umgebungsvariable abgerufen werden, die standardmäßig nicht in der Tasksequenz konfiguriert ist. Wenn für uTimeoutInSeconds eine leere Zeichenfolge angegeben und SMSTSErrorDialogTimeout nicht angegeben wird, wird der Standardwert von 900 Sekunden verwendet.

bWillReboot

Datentyp: ULONG

Qualifizierer: [in]

Boolescher Wert Es gibt an, ob die Tasksequenz den Computer neu startet, wenn das Dialogfeld geschlossen wird oder das Timeout abläuft.

pszTaskSequenceStepName

Datentyp: BSTR

Qualifizierer: [in]

Zeiger auf den Text für den Namen des Schrittnamens, der im Standardtext pszErrorMessage angezeigt wird. Der Wert kann aus der Umgebungsvariablen _SMSTSLastActionName abgerufen werden.

Rückgabewerte

Ein HRESULT Code. Mögliche Werte sind unter anderem der folgende Wert. Es werden keine HRESULT Werte zurückgegeben, die für diese Methode spezifisch sind.

S_OK Die Methode war erfolgreich.

Siehe auch

  • Last updated on