Compartilhar via

Método IProgressUI::ShowErrorDialog

No Configuration Manager, o ShowErrorDialog método apresenta informações de erro personalizáveis numa 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

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

pszErrorMessage

Tipo de dados: BSTR

Qualificadores: [in]

Ponteiro para o texto da mensagem personalizada apresentada na caixa de diálogo de erro. Transmita uma cadeia vazia se não houver uma mensagem personalizada para mostrar. O texto predefinido inclui o texto de pszTaskSequenceName, pszTaskSequenceStepNamee uErrorCode. Altera-se consoante os valores especificados.

uErrorCode

Tipo de dados: ULONG

Qualificadores: [in]

Ponteiro para o código de retorno do último passo que falhou. O valor pode ser obtido a _SMSTSLastActionRetCode partir da variável de ambiente. Se não for especificado texto personalizado para pszErrorMessage , uErrorCode será apresentado no formato de código de erro do sistema Microsoft .

uTimeoutInSeconds

Tipo de dados: ULONG

Qualificadores: [in]

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

bWillReboot

Tipo de dados: ULONG

Qualificadores: [in]

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

pszTaskSequenceStepName

Tipo de dados: BSTR

Qualificadores: [in]

Ponteiro para o texto para o nome do nome do passo que será apresentado no texto predefinido pszErrorMessage . O valor pode ser obtido a _SMSTSLastActionName partir da variável de ambiente.

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.

Confira também

  • Last updated on