Methode IProgressUI::ShowErrorDialog
In Configuration Manager geeft de ShowErrorDialog methode aanpasbare foutgegevens weer 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
Kwalificatie: [in]
Wijs de naam van de organisatie aan die wordt weergegeven in het voortgangsdialoogvenster. De waarde kan worden opgehaald uit de omgevingsvariabele _SMSTSOrgName .
pszTaskSequenceName
Gegevenstype: BSTR
Kwalificatie: [in]
Aanwijzer naar de naam van de takenreeks die momenteel wordt uitgevoerd. De waarde kan worden opgehaald uit de omgevingsvariabele _SMSTSPackageName .
pszCustomTitle
Gegevenstype: BSTR
Kwalificatie: [in]
Wijs de tekst voor een aangepast bericht aan die de standaardtiteltekst vervangt die wordt weergegeven in het foutdialoogvenster. Geef een lege tekenreeks door als er geen aangepast bericht wordt weergegeven. De waarde kan worden verkregen uit de omgevingsvariabele _SMSTSCustomProgressDialogMessage .
pszErrorMessage
Gegevenstype: BSTR
Kwalificatie: [in]
Wijs de tekst aan voor het aangepaste bericht dat wordt weergegeven in het foutdialoogvenster. Geef een lege tekenreeks door als er geen aangepast bericht wordt weergegeven. De standaardtekst bevat de tekst van pszTaskSequenceName, pszTaskSequenceStepNameen uErrorCode. Dit verandert afhankelijk van de opgegeven waarden.
uErrorCode
Gegevenstype: ULONG
Kwalificatie: [in]
Wijzer naar de retourcode van de laatste stap die is mislukt. De waarde kan worden verkregen uit de omgevingsvariabele _SMSTSLastActionRetCode . Als er geen aangepaste tekst voor pszErrorMessage is opgegeven, uErrorCode wordt deze weergegeven in Microsoft indeling van de systeemfoutcode.
uTimeoutInSeconds
Gegevenstype: ULONG
Kwalificatie: [in]
Aanwijzer naar de waarde voor het aantal seconden dat het dialoogvenster wordt weergegeven voordat het wordt gesloten. De waarde kan worden verkregen uit de SMSTSErrorDialogTimeout omgevingsvariabele, die niet standaard is geconfigureerd in de takenreeks. Als een lege tekenreeks is opgegeven voor uTimeoutInSeconds en SMSTSErrorDialogTimeout niet is opgegeven, wordt de standaardwaarde van 900 seconden gebruikt.
bWillReboot
Gegevenstype: ULONG
Kwalificatie: [in]
Booleaanse waarde. Hiermee wordt aangegeven of de takenreeks de computer opnieuw opstart wanneer het dialoogvenster wordt gesloten of de time-out verloopt.
pszTaskSequenceStepName
Gegevenstype: BSTR
Kwalificatie: [in]
Wijs de tekst aan voor de naam van de stap die in de standaardtekst pszErrorMessage wordt weergegeven. De waarde kan worden opgehaald uit de omgevingsvariabele _SMSTSLastActionName .
Waarden retourneren
Een HRESULT code. Mogelijke waarden omvatten, maar zijn niet beperkt tot, de volgende waarde. Er worden geen HRESULT waarden geretourneerd die specifiek zijn voor deze methode.
S_OK
De methode is geslaagd.