IESP::Connect-Methode

Artikel
06/13/2023

Die Connect-Methode verbindet das NPP mithilfe einer angegebenen NIC mit dem Netzwerk und stellt Konfigurationsinformationen zur Verbindung bereit.

Syntax

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

Parameter

hInputBlob [in]: Behandeln Sie das BLOB, das die NIC angibt, mit der der NPP eine Verbindung herstellt, und die Konfigurationsinformationen für diese Verbindung.
StatusCallbackProc [in]: Adresse der Rückruffunktion des Benutzers, die status Updates wie Trigger empfängt. Wenn keine Rückruffunktion verwendet wird, legen Sie diesen Parameter und den UserContext-Parameter auf NULL fest.
UserContext [in]: Der Wert wird übergeben, 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 wird, 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 die 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 vom internen IESP::Configure-Aufruf zurückgegebenen Fehler):

Rückgabecode	Beschreibung
NMERR_ALREADY_CONNECTED	Dieser instance des NPP-COM-Objekts ist bereits mit dem Netzwerk verbunden.
NMERR_BLOB_CONVERSION_ERROR	Das Konfigurationsblob ist beschädigt. Dieser Fehler wird vom IESP::Configure-Aufruf generiert.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Dem vom hInputBlob-Parameter angegebenen Eingabeblob fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Dieser Fehler kann vom IESP::Connect - oder IESP::Configure-Aufruf generiert werden. Sehen Sie sich das von hErrorBlob zurückgegebene Fehlerblob an, um zu ermitteln, welcher Eintrag nicht gefunden wurde.
NMERR_BLOB_NOT_INITIALIZED	Die CreateBlob-Funktion wurde nicht aufgerufen. Dieser Fehler wird vom IESP::Configure-Aufruf generiert.
NMERR_BLOB_STRING_INVALID	Die Zeichenfolge ist nicht null-beendet. Dieser Fehler wird vom IESP::Configure-Aufruf generiert.
NMERR_ILLEGAL_TRIGGER	Der Triggerteil des Eingabeblobs ist beschädigt. Dieser Fehler wird vom IESP::Configure-Aufruf generiert.
NMERR_INVALID_BLOB	Das in hInputBlob angegebene Objekt ist kein BLOB. Dieser Fehler wird vom IESP::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	Der für diesen Vorgang erforderliche Arbeitsspeicher ist nicht verfügbar. Dieser Fehler wird vom IESP::Configure-Aufruf generiert.
NMERR_TIMEOUT	Für die Anforderung ist ein Timeout aufgetreten. Dieser Fehler wird vom IESP::Configure-Aufruf generiert.
NMERR_UPLEVEL_BLOB	Die In hInputBlob angegebene Versionsnummer des BLOB ist falsch. Dieser Fehler wird vom IESP::Configure-Aufruf generiert.

Bemerkungen

Wenn die Connect-Methode aufgerufen wird, ruft Network Monitor automatisch IESP::Configure mithilfe des BLOB auf, das vom hInputBlob-Parameter bereitgestellt wird. Beachten Sie, dass alle Fehlercodes, die vom Aufruf von IESP::Configure zurückgegeben werden, vom IESP::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 IESP-Schnittstelle verwenden müssen, um Frames zu erfassen.

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

Das von hErrorBlob zurückgegebene Fehlerblob enthält Einträge, die der Netzwerkmonitor nicht verstehen oder in dem in hInputBlob angegebenen Eingabeblob nicht finden konnte. Das zurückgegebene Fehlerblob enthält Fehlerinformationen, die die Anwendung für die Problembehandlung verwenden kann. Wenn beispielsweise NMERR_BLOB_ENTRY_DOES_NOT_EXIST zurückgegeben wird, ist der Eintrag, den der Netzwerkmonitor nicht finden konnte, im zurückgegebenen Fehlerblob 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

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

Teilen über