Partilhar via

IProgressUI::Método ShowMessageEx

  • Artigo

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 resultados inteiros, pResult.

Sintaxe

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

Parâmetros

pszText

Tipo de dados: BSTR

Eliminatórias: [in]

O texto apresentado no corpo da caixa de mensagens.

pszCaption

Tipo de dados: BSTR

Eliminatórias: [in]

O texto apresentado no cabeçalho da caixa de mensagens.

uType

Tipo de dados: ULONG

Eliminatórias: [in]

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

  • 0 - Ok
  • 1 - Ok/Cancelar
  • 2 - Abortar/Retripar/Ignorar
  • 3 - Sim/Não/Cancelar
  • 4 - Sim/Não
  • 5 - Retry/Cancel
  • 6 - Cancelar/Tentar novamente/Continuar

pResult

Tipo de dados: INT

Eliminatórias: [fora]

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

Valores de retorno

Um HRESULT código. Os valores possíveis incluem, mas não se limitam a. Não há HRESULT valores devolvidos que sejam específicos deste método.

S_OK
O método conseguiu.

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

Exemplo

A seguinte amostra de script PowerShell mostra como usar 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 do Script 'Script', de Execução PowerShell, na sequência de tarefas. Se o utilizador selecionar Sim na janela personalizada, o script cria uma sequência de tarefas personalizada variável TS-UserPressedButton com um valor de Yes . Em seguida, pode utilizar esta variável de sequência de tarefa em outros scripts ou como condição em outros passos de sequência de tarefa.

Ver também