Metodo IDelaydC::Connect

  • Articolo

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]  LPVOID StatusCallbackProc,
  [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 sulla connessione.

StatusCallbackProc [in]

Indirizzo della funzione di callback dell'utente, utilizzata per ricevere gli aggiornamenti dello stato, ad esempio trigger. Se non viene usata alcuna 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 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 IDelaydC::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 IDelaydC::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 Il BLOB di input specificato da hInputBlob manca una voce necessaria per eseguire questa operazione. Questo errore può essere generato dalla chiamata IDelaydC::Connect o IDelaydC::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 IDelaydC::Configure .
NMERR_BLOB_STRING_INVALID
 La stringa non viene terminata con null. Questo errore viene generato dalla chiamata IDelaydC::Configure .
NMERR_ILLEGAL_TRIGGER
 La parte trigger del BLOB di input è danneggiata. Questo errore viene generato dalla chiamata IDelaydC::Configure .
NMERR_INVALID_BLOB
 L'oggetto specificato in hInputBlob non è un BLOB. Questo errore viene generato dalla chiamata IDelaydC::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
 Nessuna memoria disponibile per eseguire questa operazione. Questo errore viene generato dalla chiamata IDelaydC::Configure .
NMERR_TIMEOUT
 La richiesta è scaduta. Questo errore viene generato dalla chiamata IDelaydC::Configure .
NMERR_UPLEVEL_BLOB
 Il numero di versione del BLOB specificato in hInputBlob non è corretto. Questo errore viene generato dalla chiamata IDelaydC::Configure .

Commenti

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

Il BLOB di input specificato dal parametro hInputBlob può essere ottenuto chiamando 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

IDelaydC

IDelaydC::Configure

IDelaydC::D isconnect

IDelaydC::Start