Método IProgressUI::ShowActionProgress

En Configuration Manager, el método muestra la información de progreso de la ShowActionProgress acción personalizada en un cuadro de diálogo mientras se ejecuta la acción personalizada.

Sintaxis

[IDL]
HRESULT ShowActionProgress(
     BSTR pszOrgName,
     BSTR pszTaskSequenceName,
     BSTR pszCustomTitle,
     BSTR pszCurrentAction,
     ULONG uStep,
     ULONG uMaxStep,
     BSTR pszActionExecInfo,
     ULONG uActionExecStep,
     ULONG uActionExecMaxStep
);

Parámetros

pszOrgName

Tipo de datos: BSTR

Clasificatorios: [en]

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

Clasificatorios: [en]

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

Clasificatorios: [en]

Puntero al texto de un mensaje personalizado que reemplaza el texto de título predeterminado mostrado en el cuadro de diálogo de progreso. Pase una cadena vacía si no hay ningún mensaje personalizado que mostrar. El valor se puede obtener a partir de la _SMSTSCustomProgressDialogMessage variable de entorno.

pszCurrentAction

Tipo de datos: BSTR

Clasificatorios: [en]

Puntero al nombre del paso de la secuencia de tareas actual. El valor se puede obtener a partir de la _SMSTSCurrentActionName variable de entorno.

uStep

Tipo de datos: ULONG

Clasificatorios: [en]

El número de paso de la secuencia de tareas actual. El valor se puede obtener a partir de la SMSTSNextInstructionPointer variable de entorno.

uMaxStep

Tipo de datos: ULONG

Clasificatorios: [en]

El número total de pasos de la secuencia de tareas. El valor se puede obtener a partir de la _SMSTSInstructionTableSize variable de entorno.

pszActionExecInfo

Tipo de datos: BSTR

Clasificatorios: [en]

Puntero a la información de progreso específica de la acción definida por el usuario que se muestra en el cuadro de diálogo de progreso.

uActionExecStep

Tipo de datos: ULONG

Clasificatorios: [en]

El paso numérico, dentro del número total de pasos numéricos, en el que está trabajando actualmente la acción.

Use este parámetro para determinar el porcentaje de la acción que se ha completado hasta ahora. Para obtener más información, vea Comentarios.

uActionExecMaxStep

Tipo de datos: ULONG

Clasificatorios: [en]

Número total de pasos numéricos que realiza la acción.

Use este parámetro para determinar el porcentaje de la acción que se ha completado hasta ahora. Para obtener más información, vea Comentarios.

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.

Comentarios

La única información necesaria para este método es para los pszActionExecInfouActionExecStep, , y los uActionExecMaxStep parámetros. Los demás parámetros se pueden obtener a partir de las variables de entorno a las que se hace referencia.

Una llamada a ShowActionProgress debe especificar el porcentaje de finalización de la acción utilizando los uActionExecStep parámetros and uActionExecMaxStep . Por ejemplo, si uActionExecStep especifica el valor 2 y uActionExecMaxStep especifica el valor 10, el porcentaje de finalización de la acción es del 20 por ciento.

Vea también

  • Last updated on