Metodo IRTC::Connect

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 FramesCallbackProc,
  [in]  LPVOID UserContext,
  [out] HBLOB  hErrorBlob
);

Parametri

hInputBlob [in]

Gestire il BLOB che specifica la scheda di interfaccia di rete a cui ci si connette e le informazioni di configurazione per tale connessione.

StatusCallbackProc [in]

Indirizzo della funzione di callback dello stato dell'utente, che riceve gli aggiornamenti dello stato, ad esempio trigger. Questo parametro può essere impostato su NULL.

FrameCallbackProc [in]

Indirizzo della funzione di callback frame dell'utente, utilizzata per ricevere gli aggiornamenti dello stato, ad esempio trigger. Questo parametro può essere impostato su NULL.

UserContext [in]

Valore passato quando viene chiamata la funzione di callback dello stato e del frame dell'utente. Se vengono specificate entrambe le funzioni di callback, devono usare lo stesso valore del contesto utente. Il valore di questo parametro è in genere HWND o un puntatore 'this'.

hErrorBlob [out]

Gestire un BLOB di errore contenente informazioni aggiuntive sugli errori. Per informazioni su ciò che si trova nel BLOB di errore, vedere Osservazioni nella parte inferiore di questo argomento.

Valore restituito

Se questo 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 IRTC::Configure interna):

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 IRTC::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 può essere generato dalla chiamata IRTC::Connect o IRTC::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 IRTC::Configure .
NMERR_BLOB_STRING_INVALID	La stringa non viene terminata con null. Questo errore viene generato dalla chiamata IRTC::Configure .
NMERR_ILLEGAL_TRIGGER	La parte trigger del BLOB di input è danneggiata. Questo errore viene generato dalla chiamata IRTC::Configure .
NMERR_INVALID_BLOB	L'oggetto specificato in hInputBlob non è un BLOB. Questo errore viene generato dalla chiamata IRTC::Configure .
NMERR_OUT_OF_MEMORY	La memoria necessaria per eseguire questa operazione non è disponibile. Questo errore viene generato dalla chiamata IRTC::Configure .
NMERR_TIMEOUT	La richiesta è scaduta. Questo errore viene generato dalla chiamata IRTC::Configure .
NMERR_UPLEVEL_BLOB	Il numero di versione del BLOB specificato in hInputBlob non è corretto. Questo errore viene generato dalla chiamata IRTC::Configure .

Commenti

Quando viene chiamato il metodo Connect , il gruppo di sicurezza di rete chiama automaticamente il metodo IRTC::Configure usando il BLOB fornito da hInputBlob. Si noti che tutti i codici di errore restituiti dalla chiamata a IRTC::Configure vengono passati indietro e restituiti dalla chiamata IRTC ::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 IRTC per acquisire frame.

Quando si chiama questa funzione, è necessario specificare una funzione di callback di stato o frame, anche se funge solo da segnaposto.

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

Il BLOB di errore restituito in hErrorBlob contiene informazioni sull'errore che lo sviluppatore o l'applicazione può usare per la risoluzione dei problemi. 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. Ad esempio, se viene restituito NMERR_BLOB_ENTRY_DOES_NOT_EXIST, la voce Monitoraggio rete non è stata individuata 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

IRTC

IRTC::Configure

IRTC::D isconnect

IRTC::Start