Metodo IRTC::Configure

Articolo
06/13/2023

Il metodo Configure invia i dati di configurazione per un'acquisizione dati.

Sintassi

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

Parametri

hConfigurationBlob [in]: Handle per il BLOB configurato dal chiamante.
hErrorBlob [out]: Handle per un BLOB di errore che contiene dati di errore aggiuntivi.

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_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	BLOB duplicato.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Il BLOB di configurazione specificato da hConfigurationBlob non dispone di una voce necessaria per eseguire questa operazione. Visualizzare il BLOB di errore restituito da hErrorBlob per determinare quale voce non è stata trovata.
NMERR_AMBIGUOUS_SPECIFIER	Manca il proprietario DEL BLOB o i dati di categoria.
NMERR_BLOB_OWNER_NOT_FOUND	La sezione Proprietario BLOB non è stata trovata.
NMERR_BLOB_CATEGORY_NOT_FOUND	La sezione Categoria BLOB non è stata trovata.
NMERR_UNKNOWN_CATEGORY	È stata trovata la sezione Categoria BLOB, ma non compresa.
NMERR_UNKNOWN_TAG	È stata trovata la sezione Tag BLOB, ma non riconosciuta.
NMERR_BLOB_CONVERSION_ERROR	IL BLOB è danneggiato.
NMERR_ILLEGAL_TRIGGER	La parte trigger del BLOB è danneggiata.
NMERR_BLOB_STRING_INVALID	La stringa non è con terminazione Null.

Commenti

È necessario applicare questo metodo per riavviare un gruppo di sicurezza di rete avviato, arrestato, ma non disconnesso.

Il BLOB di errore restituito da 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 i dati sugli errori 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 può trovare è 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

IRTC
IRTC::Connect
BLOB di Monitoraggio di rete

Condividi tramite