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

Qualifikanten: [in]

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

pszTaskSequenceName

Datentyp: BSTR

Qualifikanten: [in]

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

pszCustomTitle

Datentyp: BSTR

Qualifikanten: [in]

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

pszErrorMessage

Datentyp: BSTR

Qualifikanten: [in]

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

uErrorCode

Datentyp: ULONG

Qualifikanten: [in]

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

uTimeoutInSeconds

Datentyp: ULONG

Qualifikanten: [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 Umgebungsvariablen abgerufen werden, die standardmäßig nicht in der Tasksequenz konfiguriert ist. Wenn eine leere Zeichenfolge angegeben uTimeoutInSeconds und SMSTSErrorDialogTimeout nicht angegeben wird, wird ein Standardwert von 900 Sekunden verwendet.

bWillReboot

Datentyp: ULONG

Qualifikanten: [in]

Boolescher Wert Sie gibt an, ob die Tasksequenz den Computer neu startet, wenn das Dialogfeld geschlossen wird oder das Zeitlimit überschritten wird.

pszTaskSequenceStepName

Datentyp: BSTR

Qualifikanten: [in]

Zeiger auf den Text für den Namen des Schrittnamens, der im Standardtext pszErrorMessage angezeigt wird. Der Wert kann aus der _SMSTSLastActionName Umgebungsvariablen 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