IStats::Verbinden-Methode

Die Verbinden-Methode verbindet das NPP mit dem Netzwerk mithilfe einer angegebenen NIC 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 Statusupdates wie Trigger empfängt. Wenn eine Rückruffunktion nicht verwendet wird, legen Sie diesen Parameter und den UserContext-Parameter auf NULL fest.

UserContext [in]

Wert übergeben, wenn die Rückruffunktion des Benutzers aufgerufen wird. Der Wert dieses Parameters ist in der Regel entweder HWND oder ein "this"-Zeiger. Wenn eine Rückruffunktion nicht angegeben wird, legen Sie diesen Parameter und den StatusCallbackProc-Parameter auf NULL fest.

hErrorBlob [out]

Behandeln Sie einen Fehler-BLOB, der 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 dieser Fehler, die von den internen IStats::Konfigurieren des Aufrufs 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 Konfigurations-BLOB ist beschädigt. Dieser Fehler wird vom IStats::Configure-Aufruf generiert.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
Der vom hInputBlob-Parameter angegebene Eingabe-BLOB fehlt einem Eintrag, der zum Ausführen dieses Vorgangs benötigt wird. Dieser Fehler kann von den IStats::Verbinden oder IStats::Configure Call generiert werden. Schauen Sie sich den fehler-BLOB an, der von hErrorBlob zurückgegeben wurde, um festzustellen, welche Eingabe 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 Eingabe-BLOB 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 Standardaufnahmeverzeichnis wurde in der Registrierung nicht festgelegt. Um das Aufnahmeverzeichnis festzulegen, verwenden Sie den folgenden Pfad.
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath
NMERR_OUT_OF_MEMORY
Der Speicher, der zum Ausführen dieses Vorgangs erforderlich ist, ist nicht verfügbar. Dieser Fehler wird vom IStats::Configure-Aufruf generiert.
NMERR_TIMEOUT
Die Anforderung hat zeitlimitiert. Dieser Fehler wird vom IStats::Configure-Aufruf generiert.
NMERR_UPLEVEL_BLOB
Die Versionsnummer des in hInputBlob angegebenen BLOB ist falsch. Dieser Fehler wird vom IStats::Configure-Aufruf generiert.

Bemerkungen

Wenn die Verbinden-Methode aufgerufen wird, ruft Network Monitor automatisch die IStats::Configure-Methode mithilfe des BLOB auf, das vom hInputBlob-Parameter bereitgestellt wird. Beachten Sie, dass fehlercodes, die vom Aufruf von IStats::Configure zurückgegeben werden, zurückgegeben und vom IStats::Verbinden-Aufruf zurückgegeben werden.

Diese Methode muss aufgerufen werden, bevor Sie mit der Erfassung von Frames beginnen können. Beachten Sie, dass Beim Herstellen einer Verbindung mit dem Netzwerk mithilfe dieser Methode weiterhin die IStats-Schnittstelle zum Erfassen von Frames verwendet werden muss.

Die von hInputBlob angegebene Eingabe-BLOB kann abgerufen werden, indem Sie die Methoden GetNPPBlobFromUI, GetNPPBlobTable und SelectNPPBlobFromTable aufrufen.

Der vom hErrorBlob-Parameter zurückgegebene Fehler-BLOB enthält Einträge, die der Netzwerkmonitor nicht verstehen oder finden konnte, in dem in hInputBlob angegebenen Eingabe-BLOB. Der zurückgegebene Fehler-BLOB enthält Fehlerinformationen, die die Anwendung für die Problembehandlung verwenden kann. Wenn z. B. NMERR_BLOB_ENTRY_DOES_NOT_EXIST zurückgegeben wird, ist der Eintrag, den der Netzwerkmonitor nicht finden konnte, in den zurückgegebenen Fehler-BLOB enthalten.

Informationen über Finden Sie unter
Abrufen des Eingabe-BLOB, das eine Netzwerkschnittstellenkarte 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

Siehe auch

IStats

IStats::Konfigurieren

IStats::D isconnect

Netzwerküberwachungs-BLOBS