Condividi tramite


Funzione ExpertIndicateStatus

La funzione ExpertIndicateStatus indica la percentuale di completamento dell'analisi dell'esperto del file di acquisizione.

Sintassi

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

Parametri

hExpertKey [in]

Identificatore esperto univoco. Monitoraggio di rete passa hExpertKey all'esperto quando chiama la funzione Run .

Stato [in]

Stato corrente dell'analisi. Specificare uno dei seguenti valori EXPERTSTATUSENUMERATION .

Valore Significato
EXPERTSTATUS_INACTIVE
L'esperto non ha mai iniziato.
EXPERTSTATUS_STARTING
L'esperto sta iniziando.
EXPERTSTATUS_RUNNING
L'esperto è in esecuzione normalmente.
EXPERTSTATUS_PROBLEM
Un problema specificato nel parametro SubStatus ha arrestato l'esperto.
EXPERTSTATUS_ABORTED
Monitoraggio rete ha arrestato l'esperto.
EXPERTSTATUS_DONE
L'esperto ha completato correttamente l'analisi.

SubStatus [in]

Estensione o chiarimento delle informazioni fornite dal parametro Status .

sztext [in]

Indicatore di stato del testo facoltativo.

Questo valore di parametro può essere NULL.

PercentDone [out]

Percentuale dei dati di acquisizione elaborati dall'esperto.

Quando l'esperto completa correttamente l'analisi di un file di acquisizione, il sistema imposta la percentuale su 100. Qualsiasi numero maggiore di 99 verrà ignorato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NMERR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è NMERR_EXPERT_TERMINATE; l'esperto deve immediatamente pulire e restituire senza completare l'acquisizione.

Commenti

La funzione ExpertIndicateStatus può essere chiamata solo dagli esperti che implementano la funzione Esegui o Configura esportazione .

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Netmon.h
Libreria
Nmapi.lib
DLL
Nmapi.dll