Metodo IDelaydC::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 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 |
---|---|
|
Questa istanza dell'oggetto COM NPP è già connessa alla rete. |
|
Il BLOB di configurazione è danneggiato. Questo errore viene generato dalla chiamata IDelaydC::Configure . |
|
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. |
|
La funzione CreateBlob non è stata chiamata. Questo errore viene generato dalla chiamata IDelaydC::Configure . |
|
La stringa non viene terminata con null. Questo errore viene generato dalla chiamata IDelaydC::Configure . |
|
La parte trigger del BLOB di input è danneggiata. Questo errore viene generato dalla chiamata IDelaydC::Configure . |
|
L'oggetto specificato in hInputBlob non è un BLOB. Questo errore viene generato dalla chiamata IDelaydC::Configure . |
|
La directory di acquisizione predefinita non è stata impostata nel Registro di sistema. Usare il percorso seguente per impostare la directory di acquisizione.
|
|
Nessuna memoria disponibile per eseguire questa operazione. Questo errore viene generato dalla chiamata IDelaydC::Configure . |
|
La richiesta è scaduta. Questo errore viene generato dalla chiamata IDelaydC::Configure . |
|
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 |
|
DLL |
|