Compartir a través de

IProgressUI::ShowActionProgress (método)

  • Artículo

En Configuration Manager, el ShowActionProgress método muestra información de progreso de 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

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 progreso. 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.

pszCurrentAction

Tipo de datos: BSTR

Calificadores: [in]

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

uStep

Tipo de datos: ULONG

Calificadores: [in]

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

uMaxStep

Tipo de datos: ULONG

Calificadores: [in]

Número total de pasos en la secuencia de tareas. El valor se puede obtener de la _SMSTSInstructionTableSize variable de entorno.

pszActionExecInfo

Tipo de datos: BSTR

Calificadores: [in]

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

uActionExecStep

Tipo de datos: ULONG

Calificadores: [in]

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

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

Calificadores: [in]

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. 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.

Comentarios

La única información necesaria para este método es para los pszActionExecInfoparámetros , uActionExecStepy uActionExecMaxStep . Los demás parámetros se pueden obtener 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 mediante los uActionExecStep parámetros y 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