Dela via

IProgressUI::ShowMessageEx-metod

  • Artikel

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.

Se även