IProgressUI::ShowMessageEx-metoden

Från och med version 2006 visar metoden ShowMessageEx en anpassningsbar dialogruta. Den här metoden liknar IProgressUI::ShowMessage metoden, men innehåller också en ny resultatvariabel för heltal, pResult.

Syntax

[IDL]
HRESULT ShowMessageEx(
     BSTR pszText,
     BSTR pszCaption,
     ULONG uType,
     INT *pResult
);

Parametrar

pszText

Datatyp: BSTR

Kvalificerare: [i]

Texten som visas i meddelanderutans brödtext.

pszCaption

Datatyp: BSTR

Kvalificerare: [i]

Texten som visas i meddelanderutans fönsterrubrik.

uType

Datatyp: ULONG

Kvalificerare: [i]

Värdet som motsvarar ett 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ärden för Windows-meddelanderutan.

Returvärden

En HRESULT kod. Möjliga värden inkluderar, men är inte begränsade till, följande värde. Det returneras inga HRESULT värden 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 det här 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 i andra aktivitetssekvenssteg.

Se även

  • Last updated on