Compartilhar via

Função ExpertIndicateStatus

  • Artigo

A função ExpertIndicateStatus indica o percentual de conclusão da análise do arquivo de captura do especialista.

Sintaxe

DWORD WINAPI ExpertIndicateStatus(
  _In_  HEXPERTKEY              hExpertKey,
  _In_  EXPERTSTATUSENUMERATION Status,
  _In_  DWORD                   SubStatus,
  _In_  char                    *sztext,
  _Out_ long                    PercentDone
);

Parâmetros

hExpertKey [in]

Identificador de especialista exclusivo. O Monitor de Rede passa hExpertKey para o especialista quando ele chama a função Executar .

Status [in]

Status atual da análise. Especifique um dos seguintes valores EXPERTSTATUSENUMERATION .

Valor Significado
EXPERTSTATUS_INACTIVE
 O especialista nunca começou.
EXPERTSTATUS_STARTING
 O especialista está começando.
EXPERTSTATUS_RUNNING
 O especialista está correndo normalmente.
EXPERTSTATUS_PROBLEM
 Um problema especificado no parâmetro SubStatus interrompeu o especialista.
EXPERTSTATUS_ABORTED
 O Monitor de Rede parou o especialista.
EXPERTSTATUS_DONE
 O especialista concluiu a análise com êxito.

SubStatus [in]

Extensão ou esclarecimento de informações fornecidas pelo parâmetro Status .

sztext [in]

Indicador de status de texto opcional.

Esse valor de parâmetro pode ser NULL.

PercentDone [out]

Percentual dos dados de captura processados pelo especialista.

Quando o especialista conclui com êxito a análise de um arquivo de captura, o sistema define o percentual como 100. Qualquer número maior que 99 será ignorado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NMERR_SUCCESS.

Se a função não for bem-sucedida, o valor retornado será NMERR_EXPERT_TERMINATE; o especialista deve limpo imediatamente e retornar sem concluir a captura.

Comentários

A função ExpertIndicateStatus só pode ser chamada por especialistas que implementam a função Executar ou Configurar exportação.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Netmon.h
Biblioteca
Nmapi.lib
DLL
Nmapi.dll