Compartilhar via

Método IProgressUI::ShowMessageEx

A partir da versão 2006, o ShowMessageEx método apresenta uma caixa de diálogo personalizável. Este método é semelhante ao método IProgressUI::ShowMessage , mas também inclui uma nova variável de resultado inteiro, pResult.

Sintaxe

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

Parâmetros

pszText

Tipo de dados: BSTR

Qualificadores: [in]

O texto apresentado no corpo da caixa de mensagem.

pszCaption

Tipo de dados: BSTR

Qualificadores: [in]

O texto apresentado no cabeçalho do Windows da caixa de mensagem.

uType

Tipo de dados: ULONG

Qualificadores: [in]

O valor correspondente a um dos seguintes valores possíveis para os botões:

  • 0 - Ok
  • 1 - Ok/Cancelar
  • 2 - Abortar/Repetir/Ignorar
  • 3 - Sim/Não/Cancelar
  • 4 - Sim/Não
  • 5 - Repetir/Cancelar
  • 6 - Cancelar/Tentar Novamente/Continuar

pResult

Tipo de dados: INT

Qualificadores: [fora]

O valor desta variável é um valor devolvido da caixa de mensagem padrão do Windows.

Valores de retorno

Um HRESULT código. Os valores possíveis incluem, mas não estão limitados, o seguinte valor. Não são HRESULT devolvidos valores específicos a este método.

S_OK O método foi bem-sucedido.

Para avaliar a resposta do utilizador à caixa de mensagem, utilize o parâmetro pResult .

Exemplo

O seguinte exemplo de script do PowerShell mostra como utilizar este método:

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

Pode utilizar um script como este no passo Executar Script do PowerShell na sequência de tarefas. Se o utilizador selecionar Sim na janela personalizada, o script cria uma variável de sequência de tarefas personalizada TS-UserPressedButton com um valor de Yes. Em seguida, pode utilizar esta variável de sequência de tarefas noutros scripts ou como condição noutros passos de sequência de tarefas.

Confira também