Método IProgressUI::ShowErrorDialog

No Configuration Manager, o ShowErrorDialog método exibe informações de erro personalizáveis em uma caixa de diálogo.

Sintaxe

[IDL]
HRESULT ShowErrorDialog(
     BSTR pszOrgName,
     BSTR pszTaskSequenceName,
     BSTR pszCustomTitle,
     BSTR pszErrorMessage,
     ULONG uErrorCode,
     ULONG uTimeoutInSeconds,
     ULONG uWillReboot,
     BSTR pszTaskSequenceStepName
);

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 para o texto de uma mensagem personalizada que substitui o texto de título padrão exibido na caixa de diálogo de erro. 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.

pszErrorMessage

Tipo de dados: BSTR

Eliminatórias: [em]

Ponteiro para o texto da mensagem personalizada que é exibida na caixa de diálogo de erro. Passe uma cadeia de caracteres vazia se não houver uma mensagem personalizada para mostrar. O texto padrão inclui o texto de pszTaskSequenceName, pszTaskSequenceStepName, e uErrorCode. Ele muda dependendo de quais valores são especificados.

uErrorCode

Tipo de dados: ULONG

Eliminatórias: [em]

Ponteiro para o código de retorno da última etapa que falhou. O valor pode ser obtido da _SMSTSLastActionRetCode variável de ambiente. Se nenhum texto personalizado for especificado, uErrorCode será exibido no formato de pszErrorMessagecódigo de erro do sistema da Microsoft.

uTimeoutInSeconds

Tipo de dados: ULONG

Eliminatórias: [em]

Ponteiro para o valor do número de segundos que a caixa de diálogo é exibida antes de fechar. O valor pode ser obtido da SMSTSErrorDialogTimeout variável de ambiente, que não está configurada na sequência de tarefas por padrão. Se uma cadeia de caracteres vazia for especificada uTimeoutInSeconds e SMSTSErrorDialogTimeout não for especificada, um padrão de 900 segundos será usado.

bWillReboot

Tipo de dados: ULONG

Eliminatórias: [em]

Valor booleano. Indica se a sequência de tarefas reiniciará o computador quando a caixa de diálogo for fechada ou se o tempo limite expirar.

pszTaskSequenceStepName

Tipo de dados: BSTR

Eliminatórias: [em]

Ponteiro para o texto do nome da etapa que será exibido no texto padrão pszErrorMessage . O valor pode ser recuperado da _SMSTSLastActionName variável de ambiente.

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.

Confira também

  • Last updated on