Compartilhar via


Função de retorno de chamada LPEVALCOMCALLBACK (evalcom2.h)

A especificação LPEVALCOMCALLBACK define um protótipo de função de retorno de chamada. O método IValidate::SetStatus permite que uma ferramenta de criação receba informações sobre o progresso da validação por meio da função de retorno de chamada registrada.

Sintaxe

LPEVALCOMCALLBACK Lpevalcomcallback;

BOOL Lpevalcomcallback(
  [in] STATUSTYPES iStatus,
       LPCWSTR szData,
       LPVOID pContext
)
{...}

Parâmetros

[in] iStatus

Especifica a mensagem de status enviada por evalcom2.

Valor Significado
NULL
O valor desse parâmetro
ieStatusICECount
1
Número de ICEs que estão sendo executados.
ieStatusMerge
2
Mesclando o pacote ou o módulo de mesclagem com o arquivo .cub.
ieStatusSummaryInfo
3
Mesclando fluxos de informações de resumo.
ieStatusCreateEngine
4
Preparando-se para executar os ICEs.
ieStatusRunICE
5
Executando um ICE individual.
ieStatusStarting
6
Iniciando a validação.
ieStatusShutdown
7
Conclua a execução dos ICEs.
ieStatusSuccess
8
Validação concluída com êxito.
ieStatusFail
9
Falha na validação.
ieStatusCancel
10
A validação foi cancelada.

szData

Um valor de cadeia de caracteres que contém informações apropriadas para o status. O valor de szwData deve ser o número de ICEs que estão sendo executados se iStatus for ieStatusICECount. O valor de szwData deve ser o nome do ICE que está sendo executado se iStatus for ieStatusRunICE. Caso contrário, o valor de szwData deve ser NULL. A função de retorno de chamada deve aceitar NULL como um valor possível para esse parâmetro.

pContext

Ponteiro para um contexto de aplicativo passado para o método SetStatus . Esse parâmetro pode ser usado para verificação de erros.

Retornar valor

Valor/código retornado Descrição
VERDADE
1
O procedimento de validação deve continuar.
FALSE
0
A validação foi cancelada. A função de retorno de chamada retorna FALSE para interromper a validação.

Comentários

O método SetStatus e LPEVALCOMCALLBACK podem ser usados para fornecer informações de progresso. Por exemplo, a mensagem ieStatusICECount pode fornecer a contagem geral de escalas para uma barra de progresso. Para cada mensagem ieStatusRunICE recebida, o chamador pode incrementar a barra de progresso um tique.

Requisitos

Requisito Valor
Cliente mínimo com suporte Evalcom2.dll versão 3.0.3790.371 ou posterior
Plataforma de Destino Windows
Cabeçalho evalcom2.h

Confira também

IValidate

Usar o Evalcom2

Funções de retorno de chamada de validação