IESP::Verbinden-Methode

Die Verbinden verbindet den NPP mithilfe einer angegebenen NIC mit dem Netzwerk und stellt Konfigurationsinformationen über die Verbindung zur Verfügung.

Syntax

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

Parameter

hInputBlob [ In]

Handle für das BLOB, das die NIC angibt, mit der das NPP eine Verbindung herstellt, und die Konfigurationsinformationen für diese Verbindung angibt.

StatusCallbackProc [ In]

Adresse der Rückruffunktion des Benutzers, die Statusaktualisierungen wie Trigger empfängt. 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 wird, legen Sie diesen Parameter und den StatusCallbackProc-Parameter auf NULL fest.

hErrorBlob [ out]

Handle für ein Fehlerblob, das zusätzliche Fehlerinformationen enthält.

Rückgabewert

Wenn die Methode erfolgreich ist, ist 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 IESP::Configure-Aufruf zurückgegeben werden):

Rückgabecode Beschreibung
NMERR_ALREADY_CONNECTED
Diese Instanz des NPP-COM-Objekts ist bereits mit dem Netzwerk verbunden.
NMERR_BLOB_CONVERSION_ERROR
Das Konfigurationsblob ist beschädigt. Dieser Fehler wird durch den 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 durch den IESP::Verbinden- oder IESP::Configure-Aufruf generiert werden. Sehen Sie sich den von hErrorBlob zurückgegebenen FehlerBLOB an, um zu ermitteln, welcher Eintrag nicht gefunden wurde.
NMERR_BLOB_NOT_INITIALIZED
Die CreateBlob-Funktion wurde nicht aufgerufen. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert.
NMERR_BLOB_STRING_INVALID
Die Zeichenfolge wird nicht mit NULL beendet. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert.
NMERR_ILLEGAL_TRIGGER
Der Triggerteil des Eingabeblobs ist beschädigt. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert.
NMERR_INVALID_BLOB
Das in hInputBlob angegebene Objekt ist kein BLOB. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert.
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY
Das Standarderfassungsverzeichnis wurde in der Registrierung nicht festgelegt. Verwenden Sie den folgenden Pfad zum Festlegen des Erfassungsverzeichnisses.
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath
NMERR_OUT_OF_MEMORY
Der zum Ausführen dieses Vorgangs benötigte Arbeitsspeicher ist nicht verfügbar. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert.
NMERR_TIMEOUT
Für die Anforderung ist ein Time out erfolgt. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert.
NMERR_UPLEVEL_BLOB
Die In hInputBlob angegebene Versionsnummer des BLOB ist falsch. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert.

Bemerkungen

Wenn die Verbinden aufgerufen wird, ruft Netzwerkmonitor automatisch IESP::Configure mithilfe des BLOB auf, das vom hInputBlob-Parameter bereitgestellt wird. Beachten Sie, dass alle Fehlercodes, die durch den Aufruf von IESP::Configure zurückgegeben werden, zurückgegeben und vom IESP::Verbinden zurückgegeben werden.

Diese Methode muss aufgerufen werden, bevor Sie mit dem Erfassen von Frames beginnen können. Beachten Sie, dass Sie beim Herstellen einer Verbindung mit dem Netzwerk mit 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 ermittelt werden.

Das von hErrorBlob zurückgegebene Fehlerblob enthält Einträge, die Netzwerkmonitor in dem in hInputBlob angegebenen EingabeBLOB nicht verstehen oder finden konnten. 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, wird der Eintrag, den Netzwerkmonitor nicht finden konnte, _ _ in das zurückgegebene _ _ FehlerBLOB _ eingeschlossen.

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

Requirements (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