Partilhar via

IProgressUI::Método ShowErrorDialog

  • Artigo

No Gestor de Configuração, 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

Eliminatórias: [in]

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

pszTaskSequenceName

Tipo de dados: BSTR

Eliminatórias: [in]

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

pszCustomTitle

Tipo de dados: BSTR

Eliminatórias: [in]

Ponteiro para o texto para uma mensagem personalizada que substitua o texto do título predefinido apresentado na caixa de diálogo de erro. Passe uma corda vazia se não houver uma mensagem personalizada para mostrar. O valor pode ser obtido a partir da _SMSTSCustomProgressDialogMessage variável ambiental.

pszErrorMessage

Tipo de dados: BSTR

Eliminatórias: [in]

Ponteiro para o texto para a mensagem personalizada que é apresentada na caixa de diálogo de erro. Passe uma corda vazia se não houver uma mensagem personalizada para mostrar. O texto predefinido inclui o texto de pszTaskSequenceName pszTaskSequenceStepName , e uErrorCode . Muda dependendo dos valores especificados.

uErrorCode

Tipo de dados: ULONG

Eliminatórias: [in]

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

uTimeoutInSeconds

Tipo de dados: ULONG

Eliminatórias: [in]

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

bWillReboot

Tipo de dados: ULONG

Eliminatórias: [in]

Valor booleano. Indica se a sequência de tarefas reiniciará o computador quando o diálogo estiver fechado ou se o tempo de tempo expira.

pszTaskSequenceStepName

Tipo de dados: BSTR

Eliminatórias: [in]

Ponter o texto para o nome do nome do passo que será apresentado no texto predefinido. pszErrorMessage O valor pode ser recuperado a partir da _SMSTSLastActionName variável ambiental.

Valores de retorno

Um HRESULT código. Os valores possíveis incluem, mas não se limitam a. Não há HRESULT valores devolvidos que sejam específicos deste método.

S_OK
O método conseguiu.

Ver também