IProgressUI:: ShowMessageEx, Metoda

Począwszy od wersji 2006, ShowMessageEx Metoda wyświetla dostosowywalne okno dialogowe. Ta metoda jest podobna do metody IProgressUI:: ShowMessage , ale również zawiera nową zmienną wynikową Integer, pResult .

Składnia

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

Parametry

pszText

Typ danych: BSTR

Kwalifikatory: [in]

Tekst wyświetlany w treści okna komunikatu.

pszCaption

Typ danych: BSTR

Kwalifikatory: [in]

Tekst wyświetlany w nagłówku okna komunikatu.

uType

Typ danych: ULONG

Kwalifikatory: [in]

Wartość odpowiadająca jednej z następujących możliwych wartości przycisków:

  • 0 — OK
  • 1 — OK/Anuluj
  • 2 — Przerwij/ponów/zignoruj
  • 3 — tak/nie/Anuluj
  • 4 — tak/nie
  • 5 — spróbuj ponownie/Anuluj
  • 6 — Anuluj/spróbuj ponownie/Kontynuuj

pResult

Typ danych: INT

Kwalifikatory: [out]

Wartość tej zmiennej jest wartością zwrotną standardowego okna komunikatów systemu Windows.

Wartości zwracane

HRESULTKod. Możliwe wartości to m.in., ale nie są ograniczone do, poniżej wartości. Nie HRESULT zwrócono żadnych wartości, które są specyficzne dla tej metody.

S_OK
Wykonanie metody powiodło się.

Aby oszacować odpowiedź użytkownika do okna komunikatu, użyj parametru pResult .

Przykład

Poniższy przykładowy skrypt programu PowerShell przedstawia sposób korzystania z tej metody:

$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'
}

Możesz użyć skryptu takiego jak ten w kroku Uruchom skrypt programu PowerShell w sekwencji zadań. Jeśli użytkownik wybierze opcję tak w oknie niestandardowym, skrypt tworzy niestandardową zmienną sekwencji zadań TS-UserPressedButton o wartości Yes . Tej zmiennej sekwencji zadań można następnie użyć w innych skryptach lub jako warunek dla innych kroków sekwencji zadań.

Zobacz też