Metodo IESP::Connect

Articolo
06/13/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 sulla connessione.

Sintassi

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

Parametri

hInputBlob [in]: Gestire il BLOB che specifica la scheda di interfaccia di rete a cui si connette il gruppo di sicurezza di rete 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 trigger. Se non viene usata 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 è specificata una funzione di callback, impostare questo parametro e il parametro StatusCallbackProc su NULL.
hErrorBlob [out]: Gestire un BLOB di errore contenente informazioni aggiuntive sugli errori.

Valore restituito

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

Se il metodo ha esito negativo, il valore restituito è uno dei codici di errore seguenti(che includono tali errori restituiti dalla chiamata IESP::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 IESP::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Il BLOB di input specificato dal parametro hInputBlob manca di una voce necessaria per eseguire questa operazione. Questo errore potrebbe essere generato dalla chiamata IESP::Connect o IESP::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 IESP::Configure .
NMERR_BLOB_STRING_INVALID	La stringa non viene terminata con null. Questo errore viene generato dalla chiamata IESP::Configure .
NMERR_ILLEGAL_TRIGGER	La parte trigger del BLOB di input è danneggiata. Questo errore viene generato dalla chiamata IESP::Configure .
NMERR_INVALID_BLOB	L'oggetto specificato in hInputBlob non è un BLOB. Questo errore viene generato dalla chiamata IESP::Configure .
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY	La directory di acquisizione predefinita non è stata impostata nel Registro di sistema. Usare il percorso seguente per impostare la directory di acquisizione. `HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath`
NMERR_OUT_OF_MEMORY	La memoria necessaria per eseguire questa operazione non è disponibile. Questo errore viene generato dalla chiamata IESP::Configure .
NMERR_TIMEOUT	La richiesta è scaduta. Questo errore viene generato dalla chiamata IESP::Configure .
NMERR_UPLEVEL_BLOB	Il numero di versione del BLOB specificato in hInputBlob non è corretto. Questo errore viene generato dalla chiamata IESP::Configure .

Commenti

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

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

Il BLOB di input specificato da hInputBlob può essere ottenuto chiamando GetNPPBlobFromUI, GetNPPBlobTable eSelectNPPBlobFromTable.

Il BLOB di errore restituito da hErrorBlob contiene voci che Monitoraggio di rete non è riuscito a comprendere o trovare nel BLOB di input specificato in hInputBlob. IL BLOB di errore restituito contiene informazioni sull'errore che l'applicazione può usare per la risoluzione dei problemi. Ad esempio, se NMERR_BLOB_ENTRY_DOES_NOT_EXIST viene restituito, la voce che Monitoraggio di rete non è riuscita a trovare è 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

IESP
IESP::Configure
IESP::D isconnect
IESP::Start

Condividi tramite