Metodo IStats::Connect

Articolo
06/12/2023

Il metodo Connect connette il gruppo di sicurezza di rete alla rete usando una scheda di interfaccia di rete specificata e fornisce informazioni di configurazione per la connessione.

Sintassi

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB  hInputBlob,
  [in]  LPVOID StatusCallbackProc,
  [in]  LPVOID UserContext,
  [out] HBLOB  hErrorBlob
);

Parametri

hInputBlob [in]: Gestire nel BLOB che specifica la scheda di interfaccia di rete a cui si connette il NPP e le informazioni di configurazione per tale connessione.
StatusCallbackProc [in]: Indirizzo della funzione di callback dell'utente, che riceve gli aggiornamenti dello stato, ad esempio i trigger. Se non viene utilizzata una funzione di callback, impostare questo parametro e il parametro UserContext su NULL.
UserContext [in]: Valore passato quando viene chiamata la funzione di callback dell'utente. Il valore di questo parametro è in genere HWND o un puntatore 'this'. Se non viene specificata una funzione di callback, impostare questo parametro e il parametro StatusCallbackProc su NULL.
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 (che includono gli errori restituiti dalla chiamata interna IStats::Configure ):

Codice restituito	Descrizione
NMERR_ALREADY_CONNECTED	Questa istanza dell'oggetto COM NPP è già connessa alla rete.
NMERR_BLOB_CONVERSION_ERROR	Il BLOB di configurazione è danneggiato. Questo errore viene generato dalla chiamata IStats::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Il BLOB di input specificato dal parametro hInputBlob non dispone di una voce necessaria per eseguire questa operazione. Questo errore può essere generato dalla chiamata IStats::Connect o IStats::Configure . Esaminare il BLOB di errore restituito da hErrorBlob per determinare quale voce non è stata trovata.
NMERR_BLOB_NOT_INITIALIZED	La funzione CreateBlob non è stata chiamata. Questo errore viene generato dalla chiamata IStats::Configure .
NMERR_BLOB_STRING_INVALID	La stringa non è con terminazione Null. Questo errore viene generato dalla chiamata IStats::Configure .
NMERR_ILLEGAL_TRIGGER	La parte trigger del BLOB di input è danneggiata. Questo errore viene generato dalla chiamata IStats::Configure .
NMERR_INVALID_BLOB	L'oggetto specificato in hInputBlob non è un BLOB. Questo errore viene generato dalla chiamata IStats::Configure .
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY	La directory di acquisizione predefinita non è stata impostata nel Registro di sistema. Per impostare la directory di acquisizione, usare il percorso seguente. `HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath`
NMERR_OUT_OF_MEMORY	Memoria necessaria per eseguire questa operazione non disponibile. Questo errore viene generato dalla chiamata IStats::Configure .
NMERR_TIMEOUT	Timeout della richiesta. Questo errore viene generato dalla chiamata IStats::Configure .
NMERR_UPLEVEL_BLOB	Il numero di versione del BLOB specificato in hInputBlob non è corretto. Questo errore viene generato dalla chiamata IStats::Configure .

Commenti

Quando viene chiamato il metodo Connect , Monitoraggio di rete chiama automaticamente il metodo IStats::Configure usando il BLOB fornito dal parametro hInputBlob . Si noti che tutti i codici di errore restituiti dalla chiamata a IStats::Configure vengono passati di nuovo e restituiti dalla chiamata IStats::Connect .

Questo metodo deve essere chiamato prima di poter avviare l'acquisizione dei fotogrammi. Si noti che quando ci si connette alla rete usando questo metodo, è necessario continuare a usare l'interfaccia IStats per acquisire i fotogrammi.

Il BLOB di input specificato da hInputBlob può essere ottenuto chiamando i metodi GetNPPBlobFromUI, GetNPPBlobTable e SelectNPPBlobFromTable .

Il BLOB degli errori restituito dal parametro hErrorBlob contiene voci che Monitoraggio di rete non è riuscito a comprendere o trovare nel BLOB di input specificato in hInputBlob. 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 che Monitoraggio di rete non è stata trovata viene inclusa nel BLOB di errore restituito.

Per informazioni su	Vedere
Recupero del BLOB di input che rappresenta una scheda di interfaccia di rete	Selezione di una scheda di interfaccia di rete

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::Configure
IStats::D isconnect
BLOB di Monitoraggio di rete

Condividi tramite