Método IProgressUI::ShowMessageEx

A partir de la versión 2006, el método muestra un cuadro de ShowMessageEx diálogo personalizable. Este método es similar al método IProgressUI::ShowMessage , pero también incluye una nueva variable de resultado entero, pResult.

Sintaxis

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

Parámetros

pszText

Tipo de datos: BSTR

Clasificatorios: [en]

El texto que se muestra en el cuerpo del cuadro de mensaje.

pszCaption

Tipo de datos: BSTR

Clasificatorios: [en]

El texto que se muestra en el encabezado de windows del cuadro de mensaje.

uType

Tipo de datos: ULONG

Clasificatorios: [en]

El valor correspondiente a uno de los siguientes valores posibles de los botones:

  • 0 - Aceptar
  • 1 - Aceptar/Cancelar
  • 2 - Cancelar/Reintentar/Omitir
  • 3 - Sí/No/Cancelar
  • 4 - Sí/No
  • 5 - Reintentar/cancelar
  • 6 - Cancelar/Volver a intentarlo/Continuar

pResult

Tipo de datos: INT

Clasificatorios: [fuera]

El valor de esta variable es un valor de retorno estándar del cuadro de mensajes de Windows.

Valores devueltos

Un HRESULT código. Entre los posibles valores se incluyen, entre otros, los siguientes valores. No se devuelven valores HRESULT específicos de este método.

S_OK El método se ha realizado correctamente.

Para evaluar la respuesta del usuario al cuadro de mensaje, use el parámetro pResult .

Ejemplo

El siguiente ejemplo de script de PowerShell muestra cómo 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'
}

Puede usar un script como este en el paso Ejecutar script de PowerShell en la secuencia de tareas. Si el usuario selecciona Sí en la ventana personalizada, el script crea una variable de secuencia de tareas personalizada TS-UserPressedButton con un valor de Yes. A continuación, puede usar esta variable de secuencia de tareas en otros scripts o como condición en otros pasos de secuencia de tareas.

Vea también

  • Last updated on