Compartir a través de

Función ExpertIndicateStatus

  • Artículo

La función ExpertIndicateStatus indica el porcentaje de finalización del análisis del experto del archivo de captura.

Sintaxis

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

Parámetros

hExpertKey [in]

Identificador de experto único. Network Monitor pasa hExpertKey al experto cuando llama a la función Run .

Estado [in]

Estado actual del análisis. Especifique uno de los siguientes valores EXPERTSTATUSENUMERATION .

Valor Significado
EXPERTSTATUS_INACTIVE
 El experto nunca comenzó.
EXPERTSTATUS_STARTING
 El experto está empezando.
EXPERTSTATUS_RUNNING
 El experto se está ejecutando con normalidad.
EXPERTSTATUS_PROBLEM
 Un problema especificado en el parámetro SubStatus detuvo al experto.
EXPERTSTATUS_ABORTED
 Network Monitor detuvo al experto.
EXPERTSTATUS_DONE
 El experto finalizó el análisis correctamente.

SubStatus [in]

Extensión o aclaración de la información proporcionada por el parámetro Status .

sztext [in]

Indicador de estado de texto opcional.

Este valor de parámetro puede ser NULL.

PercentDone [out]

Porcentaje de los datos de captura que ha procesado el experto.

Cuando el experto completa correctamente el análisis de un archivo de captura, el sistema establece el porcentaje en 100. Se omitirá cualquier número mayor que 99.

Valor devuelto

Si la función se realiza correctamente, se NMERR_SUCCESS el valor devuelto.

Si la función no se realiza correctamente, el valor devuelto es NMERR_EXPERT_TERMINATE; el experto debe limpiar y volver inmediatamente sin completar la captura.

Observaciones

Los expertos que implementan la función Run o Configure export solo pueden llamar a la función ExpertIndicateStatus.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Netmon.h
Biblioteca
Nmapi.lib
Archivo DLL
Nmapi.dll