IProgressUI::ShowErrorDialog methode

In Configuration Manager wordt met de ShowErrorDialog methode aanpasbare foutinformatie weergegeven in een dialoogvenster.

Syntaxis

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

Parameters

pszOrgName

Gegevenstype: BSTR

Kwalificaties: [in]

Aanwijzer naar de naam van de organisatie die wordt weergegeven in het voortgangsdialoogvenster. De waarde kan worden opgehaald uit de _SMSTSOrgName omgevingsvariabele.

pszTaskSequenceName

Gegevenstype: BSTR

Kwalificaties: [in]

Aanwijzer naar de naam van de takenreeks die momenteel wordt uitgevoerd. De waarde kan worden opgehaald uit de _SMSTSPackageName omgevingsvariabele.

pszCustomTitle

Gegevenstype: BSTR

Kwalificaties: [in]

Aanwijzer naar de tekst voor een aangepast bericht ter vervanging van de standaardtiteltekst in het dialoogvenster Fout. Geef een lege tekenreeks door als er geen aangepast bericht is om weer te geven. De waarde kan worden opgehaald uit de _SMSTSCustomProgressDialogMessage omgevingsvariabele.

pszErrorMessage

Gegevenstype: BSTR

Kwalificaties: [in]

Aanwijzer naar de tekst voor het aangepaste bericht die in het foutdialoogvenster wordt weergegeven. Geef een lege tekenreeks door als er geen aangepast bericht is om weer te geven. De standaardtekst bevat de tekst uit pszTaskSequenceName, pszTaskSequenceStepName, en uErrorCode. De waarde is afhankelijk van de opgegeven waarden.

uErrorCode

Gegevenstype: ULONG

Kwalificaties: [in]

Verwijzing naar de retourcode van de laatste stap die is mislukt. De waarde kan worden opgehaald uit de _SMSTSLastActionRetCode omgevingsvariabele. Als er geen aangepaste tekst is pszErrorMessage opgegeven, uErrorCode wordt deze weergegeven in de systeemfoutcode-indeling van Microsoft .

uTimeoutInSeconds

Gegevenstype: ULONG

Kwalificaties: [in]

Aanwijzer op de waarde voor het aantal seconden dat het dialoogvenster wordt weergegeven voordat het wordt gesloten. De waarde kan worden opgehaald uit de SMSTSErrorDialogTimeout omgevingsvariabele, die niet standaard is geconfigureerd in de taakvolgorde. Als een lege tekenreeks is opgegeven en uTimeoutInSecondsSMSTSErrorDialogTimeout niet is opgegeven, wordt een standaardwaarde van 900 seconden gebruikt.

bWillReboot

Gegevenstype: ULONG

Kwalificaties: [in]

Booleaanse waarde. Deze geeft aan of met de taakreeks de computer opnieuw wordt opgestart wanneer het dialoogvenster wordt gesloten of wanneer de time-out verloopt.

pszTaskSequenceStepName

Gegevenstype: BSTR

Kwalificaties: [in]

Aanwijzer naar de tekst voor de naam van de stapnaam die in de standaardtekst pszErrorMessage wordt weergegeven. De waarde kan worden opgehaald uit de _SMSTSLastActionName omgevingsvariabele.

Retourwaarden

Een HRESULT code. Mogelijke waarden zijn onder meer: de volgende waarde. Er worden geen HRESULT waarden geretourneerd die specifiek zijn voor deze methode.

S_OK De methode is geslaagd.

Zie ook