IRTC::Connect-Methode

Die Connect-Methode verbindet das NPP mithilfe einer angegebenen Netzwerkkarte mit dem Netzwerk und stellt Konfigurationsinformationen für die Verbindung bereit.

Syntax

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

Parameter

hInputBlob [in]

Handle an das BLOB, das die NIC angibt, mit der Sie eine Verbindung herstellen, und die Konfigurationsinformationen für diese Verbindung.

StatusCallbackProc [in]

Adresse der status Rückruffunktion des Benutzers, die status Updates wie Trigger empfängt. Dieser Parameter kann auf NULL festgelegt werden.

FramesCallbackProc [in]

Adresse der Framerückruffunktion des Benutzers, die verwendet wird, um status Updates wie Trigger zu empfangen. Dieser Parameter kann auf NULL festgelegt werden.

UserContext [in]

Wert, der übergeben wird, wenn die status- und Framerückruffunktion des Benutzers aufgerufen wird. Wenn beide Rückruffunktionen angegeben sind, müssen sie denselben Benutzerkontextwert verwenden. Der Wert dieses Parameters ist in der Regel entweder HWND oder ein "this"-Zeiger.

hErrorBlob [out]

Behandeln sie ein Fehlerblob, das zusätzliche Fehlerinformationen enthält. Informationen dazu, was sich im Fehlerblob befindet, finden Sie unter Hinweise am Ende dieses Themas.

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 IRTC::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 IRTC::Configure-Aufruf generiert.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Dem durch den hInputBlob-Parameter angegebenen Eingabeblob fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Dieser Fehler kann vom IRTC::Connect- oder IRTC::Configure-Aufruf generiert werden. 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 IRTC::Configure-Aufruf generiert.
NMERR_BLOB_STRING_INVALID	Die Zeichenfolge ist nicht NULL-beendet. Dieser Fehler wird vom IRTC::Configure-Aufruf generiert.
NMERR_ILLEGAL_TRIGGER	Der Triggerteil des Eingabeblobs ist beschädigt. Dieser Fehler wird vom IRTC::Configure-Aufruf generiert.
NMERR_INVALID_BLOB	Das in hInputBlob angegebene Objekt ist kein BLOB. Dieser Fehler wird vom IRTC::Configure-Aufruf generiert.
NMERR_OUT_OF_MEMORY	Der für diesen Vorgang erforderliche Arbeitsspeicher ist nicht verfügbar. Dieser Fehler wird vom IRTC::Configure-Aufruf generiert.
NMERR_TIMEOUT	Für die Anforderung ist ein Timeout aufgetreten. Dieser Fehler wird vom IRTC::Configure-Aufruf generiert.
NMERR_UPLEVEL_BLOB	Die Versionsnummer des in hInputBlob angegebenen BLOB ist falsch. Dieser Fehler wird vom IRTC::Configure-Aufruf generiert.

Bemerkungen

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

Diese Methode muss aufgerufen werden, bevor Sie mit der Erfassung von Frames beginnen können. Beachten Sie, dass Sie, wenn Sie mithilfe dieser Methode eine Verbindung mit dem Netzwerk herstellen, weiterhin die IRTC-Schnittstelle verwenden müssen, um Frames zu erfassen.

Beim Aufrufen dieser Funktion müssen Sie eine status- oder Framerückruffunktion angeben, auch wenn sie nur als Platzhalter fungiert.

Das durch hInputBlob angegebene Eingabeblob kann durch Aufrufen der Methoden 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

Siehe auch

IRTC

IRTC::Configure

IRTC::D isconnect

IRTC::Start