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 Namen der Organisation, 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 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.