Metoda IProgressUI::ShowMessageEx

Począwszy od wersji 2006, metoda ShowMessageEx wyświetla okno dialogowe z możliwością dostosowania. Ta metoda jest podobna do metody IProgressUI::ShowMessage , ale zawiera również nową zmienną wynikową w postaci liczb całkowitych, 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 komunikatu.

pszCaption

Typ danych: BSTR

Kwalifikatory: [in]

Tekst wyświetlany w nagłówku okna okna wiadomości.

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 próbę/Ignoruj
  • 3 - Tak/Nie/Anuluj
  • 4 - Tak/Nie
  • 5. Ponów próbę/Anuluj
  • 6. Anuluj/Spróbuj ponownie/Kontynuuj

pResult

Typ danych: INT

Kwalifikacje: [out]

Wartość tej zmiennej jest standardową wartością zwracaną przez okno komunikatu systemu Windows.

Wartości zwracane

Kod HRESULT . Możliwe wartości to między innymi następujące wartości, ale nie są do nich ograniczone. Nie są zwracane żadne HRESULT wartości specyficzne dla tej metody.

S_OK Metoda zakończyła się powodzeniem.

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

Przykład

Poniższy przykładowy skrypt programu PowerShell ilustruje sposób użycia 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 podobnego do tego w kroku Uruchom skrypt programu PowerShell w sekwencji zadań. Jeśli użytkownik wybierze Tak w oknie niestandardowym, skrypt utworzy niestandardową zmienną sekwencji zadań TS-UserPressedButton o wartości Yes. Następnie można użyć tej zmiennej sekwencji zadań w innych skryptach lub jako warunku w innych krokach sekwencji zadań.

Zobacz też

  • Last updated on