IStats::Connect-Methode

Artikel
06/13/2023

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

Syntax

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB  hInputBlob,
  [in]  LPVOID StatusCallbackProc,
  [in]  LPVOID 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 IStats::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 IStats::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 IStats::Connect - oder IStats::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 IStats::Configure-Aufruf generiert.
NMERR_BLOB_STRING_INVALID	Die Zeichenfolge ist nicht null-beendet. Dieser Fehler wird vom IStats::Configure-Aufruf generiert.
NMERR_ILLEGAL_TRIGGER	Der Triggerteil des Eingabeblobs ist beschädigt. Dieser Fehler wird vom IStats::Configure-Aufruf generiert.
NMERR_INVALID_BLOB	Das in hInputBlob angegebene Objekt ist kein BLOB. Dieser Fehler wird vom IStats::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 war nicht verfügbar. Dieser Fehler wird vom IStats::Configure-Aufruf generiert.
NMERR_TIMEOUT	Für die Anforderung ist ein Timeout aufgetreten. Dieser Fehler wird vom IStats::Configure-Aufruf generiert.
NMERR_UPLEVEL_BLOB	Die In hInputBlob angegebene Versionsnummer des BLOB ist falsch. Dieser Fehler wird vom IStats::Configure-Aufruf generiert.

Bemerkungen

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

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

Das vom hErrorBlob-Parameter zurückgegebene Fehlerblob enthält Einträge, die der Netzwerkmonitor in dem in hInputBlob angegebenen Eingabeblob nicht verstehen oder 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 Netzwerkschnittstelle darstellt, Karte	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

IStats
IStats::Configure
IStats::D isconnect
Netzwerkmonitorblobs

Freigeben über