Método IProgressUI::ShowActionProgress

No Configuration Manager, o método exibe informações de progresso da ShowActionProgress ação personalizada em uma caixa de diálogo enquanto a ação personalizada está em execução.

Sintaxe

[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 dados: BSTR

Eliminatórias: [em]

Ponteiro para o nome da organização que é mostrado na caixa de diálogo de progresso. O valor pode ser recuperado da _SMSTSOrgName variável de ambiente.

pszTaskSequenceName

Tipo de dados: BSTR

Eliminatórias: [em]

Ponteiro para o nome da sequência de tarefas que está sendo executada no momento. O valor pode ser recuperado da _SMSTSPackageName variável de ambiente.

pszCustomTitle

Tipo de dados: BSTR

Eliminatórias: [em]

Ponteiro sobre o texto de uma mensagem personalizada que substitui o texto de título padrão exibido na caixa de diálogo de progresso. Passe uma cadeia de caracteres vazia se não houver uma mensagem personalizada para mostrar. O valor pode ser obtido da _SMSTSCustomProgressDialogMessage variável de ambiente.

pszCurrentAction

Tipo de dados: BSTR

Eliminatórias: [em]

Ponteiro para o nome da etapa da sequência de tarefas atual. O valor pode ser obtido da _SMSTSCurrentActionName variável de ambiente.

uStep

Tipo de dados: ULONG

Eliminatórias: [em]

O número da etapa da sequência de tarefas atual. O valor pode ser obtido da SMSTSNextInstructionPointer variável de ambiente.

uMaxStep

Tipo de dados: ULONG

Eliminatórias: [em]

O número total de etapas na sequência de tarefas. O valor pode ser obtido da _SMSTSInstructionTableSize variável de ambiente.

pszActionExecInfo

Tipo de dados: BSTR

Eliminatórias: [em]

Ponteiro para informações de progresso específicas da ação definidas pelo usuário a serem exibidas na caixa de diálogo de progresso.

uActionExecStep

Tipo de dados: ULONG

Eliminatórias: [em]

A etapa numérica, dentro do número total de etapas numéricas, na qual a ação está funcionando no momento.

Use esse parâmetro para determinar a porcentagem da ação que foi concluída até o momento. Para obter mais informações, consulte Comentários.

uActionExecMaxStep

Tipo de dados: ULONG

Eliminatórias: [em]

O número total de etapas numéricas que a ação executa.

Use esse parâmetro para determinar a porcentagem da ação que foi concluída até o momento. Para obter mais informações, consulte Comentários.

Valores de retorno

Um HRESULT código. Os valores possíveis incluem, mas não estão limitados a, o valor a seguir. Não há HRESULT valores retornados específicos para esse método.

S_OK O método foi bem-sucedido.

Comentários

As únicas informações necessárias para esse método são os pszActionExecInfoparâmetros , uActionExecStep, e uActionExecMaxStep . Os outros parâmetros podem ser obtidos a partir das variáveis de ambiente referenciadas.

Uma chamada para ShowActionProgress deve especificar a porcentagem de conclusão da ação usando os uActionExecStep parâmetros and uActionExecMaxStep . Por exemplo, se uActionExecStep especifica o valor 2 e uActionExecMaxStep especifica o valor 10, a porcentagem de conclusão da ação é de 20%.

Confira também

  • Last updated on