Metodo IStats::Configure

Articolo
06/13/2023

Il metodo Configure invia le informazioni di configurazione di acquisizione.

Sintassi

HRESULT STDMETHODCALLTYPE Configure(
  [in]  HBLOB hConfigurationBlob,
  [out] HBLOB hErrorBlob
);

Parametri

hConfigurationBlob [in]: Gestire il BLOB configurato dal chiamante.
hErrorBlob [out]: Gestire in un BLOB di errore che contiene informazioni aggiuntive sull'errore.

Valore restituito

Se il metodo ha esito positivo, il valore restituito viene NMERR_SUCCESS.

Se il metodo ha esito negativo, il valore restituito è uno dei codici di errore seguenti:

Codice restituito	Descrizione
NMERR_BLOB_STRING_INVALID	La stringa non è con terminazione Null.
NMERR_BLOB_NOT_INITIALIZED	Il metodo CreateBlob non è stato chiamato.
NMERR_INVALID_BLOB	L'oggetto a cui punta non è un BLOB.
NMERR_UPLEVEL_BLOB	Il numero di versione DEL BLOB non è corretto.
NMERR_BLOB_ENTRY_ALREADY_EXISTS	Esiste già una voce BLOB.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Il BLOB di configurazione specificato dal parametro hConfigurationBlob non dispone di una voce necessaria per eseguire questa operazione. Esaminare il BLOB di errore restituito dal parametro hErrorBlob per determinare quale voce non è stata trovata.
NMERR_AMBIGUOUS_SPECIFIER	Il BLOB non dispone di informazioni sul proprietario o sulla categoria.
NMERR_BLOB_OWNER_NOT_FOUND	La sezione Proprietario del BLOB non è stata trovata.
NMERR_BLOB_CATEGORY_NOT_FOUND	La sezione Category del BLOB non è stata trovata.
NMERR_UNKNOWN_CATEGORY	Le informazioni sulle categorie sono state trovate ma non comprese.
NMERR_UNKNOWN_TAG	Le informazioni sui tag sono state trovate ma non comprese.
NMERR_BLOB_CONVERSION_ERROR	IL BLOB è danneggiato.
NMERR_ILLEGAL_TRIGGER	La parte trigger del BLOB è danneggiata.

Commenti

È necessario applicare questo metodo per riavviare un NPP avviato, arrestato ma non disconnesso.

Il BLOB degli errori restituito da hErrorBlob contiene voci che Monitoraggio di rete non è riuscito a comprendere o trovare nel BLOB di configurazione specificato nel parametro hConfigurationBlob . Il BLOB degli errori restituito contiene informazioni sull'errore che l'applicazione può usare per la risoluzione dei problemi. Ad esempio, se viene restituito NMERR_BLOB_ENTRY_DOES_NOT_EXIST, la voce Monitoraggio di rete non è stata trovata viene inclusa nel BLOB di errore restituito.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Netmon.h
DLL	Ndisnpp.dll; Rmtnpp.dll

Vedi anche

IStats
ISTATS::Connect
BLOB di Monitoraggio di rete

Condividi tramite