IProgressUI::ShowErrorDialog (método)
En Configuration Manager, el ShowErrorDialog
método muestra información de error personalizable en un cuadro de diálogo.
Sintaxis
[IDL]
HRESULT ShowErrorDialog(
BSTR pszOrgName,
BSTR pszTaskSequenceName,
BSTR pszCustomTitle,
BSTR pszErrorMessage,
ULONG uErrorCode,
ULONG uTimeoutInSeconds,
ULONG uWillReboot,
BSTR pszTaskSequenceStepName
);
Parámetros
pszOrgName
Tipo de datos: BSTR
Calificadores: [in]
Puntero al nombre de la organización que se muestra en el cuadro de diálogo de progreso. El valor se puede recuperar de la _SMSTSOrgName
variable de entorno.
pszTaskSequenceName
Tipo de datos: BSTR
Calificadores: [in]
Puntero al nombre de la secuencia de tareas que se está ejecutando actualmente. El valor se puede recuperar de la _SMSTSPackageName
variable de entorno.
pszCustomTitle
Tipo de datos: BSTR
Calificadores: [in]
Puntero al texto de un mensaje personalizado que reemplaza el texto de título predeterminado que se muestra en el cuadro de diálogo de error. Pase una cadena vacía si no hay ningún mensaje personalizado que mostrar. El valor se puede obtener de la _SMSTSCustomProgressDialogMessage
variable de entorno.
pszErrorMessage
Tipo de datos: BSTR
Calificadores: [in]
Puntero al texto del mensaje personalizado que se muestra en el cuadro de diálogo de error. Pase una cadena vacía si no hay ningún mensaje personalizado que mostrar. El texto predeterminado incluye el texto de pszTaskSequenceName
, pszTaskSequenceStepName
y uErrorCode
. Cambia en función de los valores especificados.
uErrorCode
Tipo de datos: ULONG
Calificadores: [in]
Puntero al código devuelto del último paso que produjo un error. El valor se puede obtener de la _SMSTSLastActionRetCode
variable de entorno. Si no se especifica ningún texto personalizado parapszErrorMessage
, uErrorCode
se mostrará en Microsoft formato de código de error del sistema.
uTimeoutInSeconds
Tipo de datos: ULONG
Calificadores: [in]
Puntero al valor del número de segundos que se muestra el cuadro de diálogo antes de cerrar. El valor se puede obtener de la SMSTSErrorDialogTimeout
variable de entorno, que no está configurada en la secuencia de tareas de forma predeterminada. Si se especifica una cadena vacía para uTimeoutInSeconds
y SMSTSErrorDialogTimeout
no se especifica, se usará un valor predeterminado de 900 segundos.
bWillReboot
Tipo de datos: ULONG
Calificadores: [in]
Valor Boolean. Indica si la secuencia de tareas reiniciará el equipo cuando se cierre el cuadro de diálogo o expire el tiempo de espera.
pszTaskSequenceStepName
Tipo de datos: BSTR
Calificadores: [in]
Puntero al texto del nombre del paso que se mostrará en el texto predeterminado pszErrorMessage
. El valor se puede recuperar de la _SMSTSLastActionName
variable de entorno.
Valores devueltos
Un HRESULT
código. Los valores posibles incluyen, pero no se limitan a, el siguiente valor. No se HRESULT
devuelven valores específicos de este método.
S_OK
El método se realizó correctamente.