Metodo IESP::Configure

Articolo
06/13/2023

Il metodo Configure invia le informazioni di configurazione per un'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. Per informazioni sul contenuto di un BLOB di errore, vedere la sezione Osservazioni in questo argomento.

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_NOT_CONNECTED	Il NPP non è connesso alla rete.
NMERR_NOT_ESP	Il NPP è connesso alla rete, ma non con il metodo IESP::Connect .
NMERR_CAPTURING	Il NPP segnala che la sessione di acquisizione è stata avviata.
NMERR_ILLEGAL_TRIGGER	La parte trigger del BLOB di configurazione è danneggiata.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Il BLOB di configurazione specificato da hConfigurationBlob manca una voce necessaria per eseguire questa operazione. Esaminare il BLOB di errore restituito da hErrorBlob per determinare quale voce non è stata trovata.
NMERR_BLOB_CONVERSION_ERROR	IL BLOB è danneggiato.
NMERR_BLOB_NOT_INITIALIZED	Il metodo CreateBlob non è stato chiamato.
NMERR_INVALID_BLOB	L'oggetto a cui punta non è un BLOB.
NMERR_BLOB_STRING_INVALID	La stringa non è con terminazione Null.
NMERR_UPLEVEL_BLOB	Il numero di versione DEL BLOB non è corretto.
NMERR_OUT_OF_MEMORY	Memoria non disponibile. Arrestare le finestre per liberare risorse.
NMERR_TIMEOUT	Timeout della richiesta.

Commenti

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

Il BLOB degli errori restituito dal parametro hErrorBlob contiene voci che Monitoraggio di rete non è riuscito a comprendere o trovare nel BLOB di configurazione specificato in 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

Condividi tramite