IProgressUI::ShowMessageEx-metod
Från och med version 2006 ShowMessageEx visar metoden en anpassningsbar dialogruta. Den här metoden liknar metoden IProgressUI::ShowMessage , men innehåller även en ny heltalsresultatvariabel, pResult.
Syntax
[IDL]
HRESULT ShowMessageEx(
BSTR pszText,
BSTR pszCaption,
ULONG uType,
INT *pResult
);
Parametrar
pszText
Datatyp: BSTR
Kvalificerare: [in]
Texten som visas i meddelanderutans brödtext.
pszCaption
Datatyp: BSTR
Kvalificerare: [in]
Texten som visas i meddelanderutans fönsterrubrik.
uType
Datatyp: ULONG
Kvalificerare: [in]
Värdet som motsvarar något av följande möjliga värden för knapparna:
- 0 - Ok
- 1 – Ok/Avbryt
- 2 – Avbryt/försök igen/Ignorera
- 3 – Ja/Nej/Avbryt
- 4 – Ja/Nej
- 5 – Försök igen/avbryt
- 6 – Avbryt/Försök igen/Fortsätt
pResult
Datatyp: INT
Kvalificerare: [ut]
Värdet för den här variabeln är ett standardvärde för Returvärde för Windows-meddelanderutan.
Returnera värden
En HRESULT kod. Möjliga värden inkluderar, men är inte begränsade till, följande värde. Det finns inga HRESULT värden som returneras som är specifika för den här metoden.
S_OK
Metoden lyckades.
Om du vill utvärdera användarens svar på meddelanderutan använder du parametern pResult .
Exempel
Följande PowerShell-skriptexempel visar hur du använder den här metoden:
$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'
}
Du kan använda ett skript som detta i steget Kör PowerShell-skript i aktivitetssekvensen. Om användaren väljer Ja i det anpassade fönstret skapar skriptet en anpassad aktivitetssekvensvariabel TS-UserPressedButton med värdet Yes. Du kan sedan använda den här aktivitetssekvensvariabeln i andra skript eller som ett villkor för andra aktivitetssekvenssteg.