IProgressUI::ShowMessageEx — Metoda

  • Artykuł

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

Składni

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

Parametry

pszText

Typ danych: BSTR

Kwalifikatory: [w]

Tekst wyświetlany w treści pola wiadomości.

pszCaption

Typ danych: BSTR

Kwalifikatory: [w]

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

uType

Typ danych: ULONG

Kwalifikatory: [w]

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

  • 0 — OK
  • 1 — Ok/Anuluj
  • 2 — Przerywanie/ponawianie próby/ignorowanie
  • 3 — Tak/Nie/Anuluj
  • 4 — Tak/Nie
  • 5 — Ponów próbę/anuluj
  • 6 — Anuluj/spróbuj ponownie/Kontynuuj

pResult

Typ danych: INT

Kwalifikatory: [out]

Wartość tej zmiennej jest standardową wartością zwracaną w polu komunikatu systemu Windows.

Zwracane wartości

Kod HRESULT . Możliwe wartości obejmują, ale nie są ograniczone do następującej wartości. Nie są zwracane żadne HRESULT wartości specyficzne dla tej metody.

S_OK
Metoda zakończyła się pomyślnie.

Aby ocenić odpowiedź użytkownika na okno komunikatu, użyj parametru pResult .

Przykład

Poniższy przykładowy skrypt programu PowerShell pokazuje, jak używać 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'
}

Takiego skryptu można użyć w kroku Uruchamianie skryptu programu PowerShell w sekwencji zadań. Jeśli użytkownik wybierze pozycję Tak w oknie niestandardowym, skrypt utworzy niestandardową zmienną sekwencji zadań TS-UserPressedButton z wartością Yes. Następnie możesz użyć tej zmiennej sekwencji zadań w innych skryptach lub jako warunku w innych krokach sekwencji zadań.

Zobacz też