IDelaydC::Connect-Methode

Artikel
06/13/2023

Die Connect-Methode verbindet das NPP über eine angegebene Netzwerkschnittstelle Karte mit dem Netzwerk und stellt Konfigurationsinformationen zur Verbindung bereit.

Syntax

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

Parameter

hInputBlob [in]: Verarbeiten Sie das BLOB, das die NIC angibt, mit der Sie eine Verbindung herstellen, und die Konfigurationsinformationen zu dieser Verbindung.
StatusCallbackProc [in]: Adresse der Rückruffunktion des Benutzers, die verwendet wird, um status Updates wie Trigger zu empfangen. Wenn keine Rückruffunktion verwendet wird, legen Sie diesen Parameter und den UserContext-Parameter auf NULL fest.
UserContext [in]: Wert, der übergeben wird, wenn die Rückruffunktion des Benutzers aufgerufen wird. Der Wert dieses Parameters ist in der Regel entweder HWND oder ein "this"-Zeiger. Wenn keine Rückruffunktion angegeben ist, legen Sie diesen Parameter und den StatusCallbackProc-Parameter auf NULL fest.
hErrorBlob [out]: Behandeln sie ein Fehlerblob, das zusätzliche Fehlerinformationen enthält.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird der Rückgabewert NMERR_SUCCESS.

Wenn die Methode nicht erfolgreich ist, ist der Rückgabewert einer der folgenden Fehlercodes (einschließlich der Fehler, die vom internen IDelaydC::Configure-Aufruf zurückgegeben werden):

Rückgabecode	Beschreibung
NMERR_ALREADY_CONNECTED	Diese instance des NPP-COM-Objekts ist bereits mit dem Netzwerk verbunden.
NMERR_BLOB_CONVERSION_ERROR	Das Konfigurationsblob ist beschädigt. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Dem von hInputBlob angegebenen Eingabeblob fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Dieser Fehler wird möglicherweise vom IDelaydC::Connect - oder IDelaydC::Configure-Aufruf generiert. Sehen Sie sich den von hErrorBlob zurückgegebenen Fehler blob an, um zu ermitteln, welcher Eintrag nicht gefunden wurde.
NMERR_BLOB_NOT_INITIALIZED	Die CreateBlob-Funktion wurde nicht aufgerufen. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert.
NMERR_BLOB_STRING_INVALID	Die Zeichenfolge ist nicht NULL-beendet. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert.
NMERR_ILLEGAL_TRIGGER	Der Triggerteil des Eingabeblobs ist beschädigt. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert.
NMERR_INVALID_BLOB	Das in hInputBlob angegebene Objekt ist kein BLOB. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert.
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY	Das Standarderfassungsverzeichnis wurde in der Registrierung nicht festgelegt. Verwenden Sie den folgenden Pfad, um das Aufzeichnungsverzeichnis festzulegen. `HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath`
NMERR_OUT_OF_MEMORY	Für diesen Vorgang war kein Arbeitsspeicher verfügbar. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert.
NMERR_TIMEOUT	Für die Anforderung ist ein Timeout aufgetreten. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert.
NMERR_UPLEVEL_BLOB	Die Versionsnummer des in hInputBlob angegebenen BLOB ist falsch. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert.

Bemerkungen

Wenn die Connect-Methode aufgerufen wird, ruft das NPP automatisch IDelaydC::Configure mithilfe des blob auf, das von hInputBlob bereitgestellt wird. Beachten Sie, dass alle Fehlercodes, die vom Aufruf von IDelaydC::Configure zurückgegeben werden, zurückgegeben und vom IDelaydC::Connect-Aufruf zurückgegeben werden.

Diese Methode muss aufgerufen werden, bevor Sie mit der Erfassung von Frames beginnen können. Beachten Sie, dass Sie beim Herstellen einer Verbindung mit dem Netzwerk mithilfe dieser Methode weiterhin die IDelaydC-Schnittstellenmethoden verwenden müssen, um Frames zu erfassen.

Das durch den hInputBlob-Parameter angegebene Eingabeblob kann durch Aufrufen von GetNPPBlobFromUI, GetNPPBlobTable und SelectNPPBlobFromTable abgerufen werden.

Das in hErrorBlob zurückgegebene Fehlerblob enthält Fehlerinformationen, die der Entwickler oder die Anwendung für die Problembehandlung verwenden kann. Das von hErrorBlob zurückgegebene Fehlerblob enthält Einträge, die der Netzwerkmonitor in dem in hInputBlob angegebenen Eingabeblob nicht verstehen oder finden konnte. Wenn beispielsweise NMERR_BLOB_ENTRY_DOES_NOT_EXIST zurückgegeben wird, ist der Eintrag Netzwerkmonitor nicht gefunden im zurückgegebenen Fehler BLOB enthalten.

Informationen über	Finden Sie unter
Abrufen des Eingabeblobs, das eine NIC darstellt	Auswählen einer Netzwerkschnittstellenkarte

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Netmon.h
DLL	Ndisnpp.dll; Rmtnpp.dll

Weitere Informationen

IDelaydC
IDelaydC::Configure
IDelaydC::D isconnect
IDelaydC::Start

Freigeben über