Methode IProgressUI::ShowMessageEx
Vanaf versie 2006 wordt met de ShowMessageEx methode een aanpasbaar dialoogvenster weergegeven. Deze methode is vergelijkbaar met de methode IProgressUI::ShowMessage , maar bevat ook een nieuwe resultaatvariabele voor gehele getallen, pResult.
Syntaxis
[IDL]
HRESULT ShowMessageEx(
BSTR pszText,
BSTR pszCaption,
ULONG uType,
INT *pResult
);
Parameters
pszText
Gegevenstype: BSTR
Kwalificatie: [in]
De tekst die wordt weergegeven in de hoofdtekst van het berichtvak.
pszCaption
Gegevenstype: BSTR
Kwalificatie: [in]
De tekst die wordt weergegeven in de koptekst van het berichtvak.
uType
Gegevenstype: ULONG
Kwalificatie: [in]
De waarde die overeenkomt met een van de volgende mogelijke waarden voor de knoppen:
- 0 - Ok
- 1 - Ok/annuleren
- 2 - Afbreken/opnieuw proberen/negeren
- 3 - Ja/Nee/Annuleren
- 4 - Ja/Nee
- 5 - Opnieuw proberen/annuleren
- 6 - Annuleren/opnieuw proberen/doorgaan
pResult
Gegevenstype: INT
Kwalificatie: [uit]
De waarde van deze variabele is een standaardwaarde voor het windows-berichtvak.
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.
Gebruik de parameter pResult om het antwoord van de gebruiker op het berichtvak te evalueren.
Voorbeeld
In het volgende PowerShell-voorbeeldscript ziet u hoe u deze methode gebruikt:
$Message = "Can you see this message?"
$Title = "Contoso IT"
$Type = 4 # Yes/No
$Output = 0
$TaskSequenceProgressUi = New-Object -ComObject "Microsoft.SMS.TSProgressUI"
$TaskSequenceProgressUi.ShowMessageEx($Message, $Title, $Type, [ref]$Output)
$TSEnv = New-Object -ComObject "Microsoft.SMS.TSEnvironment"
if ($Output -eq 6) {
$TSEnv.Value("TS-UserPressedButton") = 'Yes'
}
U kunt een script zoals dit gebruiken in de stap PowerShell-script uitvoeren in de takenreeks. Als de gebruiker Ja selecteert in het aangepaste venster, maakt het script een aangepaste takenreeksvariabele TS-UserPressedButton met de waarde .Yes U kunt deze takenreeksvariabele vervolgens gebruiken in andere scripts of als voorwaarde voor andere takenreeksstappen.