Compartilhar via

Método IProgressUI::ShowActionProgress

No Configuration Manager, o ShowActionProgress método apresenta informações de progresso da ação personalizada numa 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

Qualificadores: [in]

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

pszTaskSequenceName

Tipo de dados: BSTR

Qualificadores: [in]

Ponteiro para o nome da sequência de tarefas que está atualmente em execução. O valor pode ser obtido a _SMSTSPackageName partir da variável de ambiente.

pszCustomTitle

Tipo de dados: BSTR

Qualificadores: [in]

Ponteiro para o texto de uma mensagem personalizada que substitui o texto de título predefinido apresentado na caixa de diálogo de progresso. Transmita uma cadeia vazia se não houver uma mensagem personalizada para mostrar. O valor pode ser obtido a _SMSTSCustomProgressDialogMessage partir da variável de ambiente.

pszCurrentAction

Tipo de dados: BSTR

Qualificadores: [in]

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

uStep

Tipo de dados: ULONG

Qualificadores: [in]

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

uMaxStep

Tipo de dados: ULONG

Qualificadores: [in]

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

pszActionExecInfo

Tipo de dados: BSTR

Qualificadores: [in]

Ponteiro para informações de progresso específicas de ação definidas pelo utilizador a serem apresentadas na caixa de diálogo de progresso.

uActionExecStep

Tipo de dados: ULONG

Qualificadores: [in]

O passo numérico, dentro do número total de passos numéricos, em que a ação está atualmente a funcionar.

Utilize este parâmetro para determinar a percentagem da ação que foi concluída até agora. Para obter mais informações, veja Observações.

uActionExecMaxStep

Tipo de dados: ULONG

Qualificadores: [in]

O número total de passos numéricos que a ação faz.

Utilize este parâmetro para determinar a percentagem da ação que foi concluída até agora. Para obter mais informações, veja Observações.

Valores de retorno

Um HRESULT código. Os valores possíveis incluem, mas não estão limitados, o seguinte valor. Não são HRESULT devolvidos valores específicos a este método.

S_OK O método foi bem-sucedido.

Comentários

A única informação necessária para este método é para os pszActionExecInfoparâmetros , uActionExecStepe uActionExecMaxStep . Os outros parâmetros podem ser obtidos a partir das variáveis de ambiente referenciadas.

Uma chamada para ShowActionProgress deve especificar a percentagem de conclusão da ação com os uActionExecStep parâmetros e uActionExecMaxStep . Por exemplo, se uActionExecStep especificar o valor 2 e uActionExecMaxStep especificar o valor 10, a conclusão percentual da ação será de 20%.

Confira também

  • Last updated on