Поделиться через

Метод IProgressUI::ShowMessageEx

  • Статья

Начиная с версии 2006, ShowMessageEx метод отображает настраиваемое диалоговое окно. Этот метод аналогичен методу IProgressUI::ShowMessage , но также включает новую целочисленную результную переменную pResult.

Синтаксис

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

Параметры

pszText

Тип данных: BSTR

Квалификаторы: [в]

Текст, отображаемый в тексте окна сообщения.

pszCaption

Тип данных: BSTR

Квалификаторы: [в]

Текст, отображаемый в заголовке окна сообщения.

uType

Тип данных: ULONG

Квалификаторы: [в]

Значение, соответствующее одному из следующих возможных значений для кнопок:

  • 0 - Ок
  • 1 — ОК/Отмена
  • 2 . Прерывание, повторная попытка или игнорировать
  • 3 - Да/Нет/Отмена
  • 4 - Да/Нет
  • 5 . Повторная попытка и отмена
  • 6 — отмена, повторная попытка или продолжение

pResult

Тип данных: INT

Квалификаторы: [out]

Значение этой переменной является стандартным возвращаемым значением окна сообщений Windows.

Возвращаемые значения

Код HRESULT . Возможные значения включают, помимо прочего, следующее значение. Значения, относящиеся к этому методу, не HRESULT возвращаются.

S_OK
Метод выполнен успешно.

Чтобы оценить ответ пользователя на окно сообщения, используйте параметр pResult .

Пример

В следующем примере скрипта PowerShell показано, как использовать этот метод:

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

Подобный скрипт можно использовать на шаге Запуск скрипта PowerShell в последовательности задач. Если пользователь выбирает Да в пользовательском окне, скрипт создает настраиваемую переменную последовательности задач TS-UserPressedButton со значением Yes. Затем эту переменную последовательности задач можно использовать в других сценариях или в качестве условия на других шагах последовательности задач.

См. также