IDelaydC::Verbinden-Methode

Die Verbinden verbindet den NPP mithilfe einer angegebenen Netzwerkschnittstellenkarte mit dem Netzwerk und stellt Konfigurationsinformationen über die Verbindung bereit.

Syntax

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

Parameter

hInputBlob [ In]

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

StatusCallbackProc [ In]

Adresse der Rückruffunktion des Benutzers, die zum Empfangen von Statusupdates wie Triggern verwendet wird. 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 diese 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 IDelaydC::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 Aufruf IDelaydC::Configure generiert.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
Dem von hInputBlob angegebenen EingabeBLOB fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Dieser Fehler kann durch den Aufruf IDelaydC::Verbinden oder IDelaydC::Configure 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 Aufruf IDelaydC::Configure generiert.
NMERR_BLOB_STRING_INVALID
Die Zeichenfolge wird nicht mit NULL beendet. Dieser Fehler wird durch den Aufruf IDelaydC::Configure generiert.
NMERR_ILLEGAL_TRIGGER
Der Triggerteil des Eingabeblobs ist beschädigt. Dieser Fehler wird durch den Aufruf IDelaydC::Configure generiert.
NMERR_INVALID_BLOB
Das in hInputBlob angegebene Objekt ist kein BLOB. Dieser Fehler wird durch den Aufruf IDelaydC::Configure 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
Für diesen Vorgang war kein Arbeitsspeicher verfügbar. Dieser Fehler wird durch den Aufruf IDelaydC::Configure generiert.
NMERR_TIMEOUT
Für die Anforderung ist ein Time out erfolgt. Dieser Fehler wird durch den Aufruf IDelaydC::Configure generiert.
NMERR_UPLEVEL_BLOB
Die In hInputBlob angegebene Versionsnummer des BLOB ist falsch. Dieser Fehler wird durch den Aufruf IDelaydC::Configure generiert.

Bemerkungen

Wenn die Verbinden aufgerufen wird, ruft das NPP automatisch IDelaydC::Configure mithilfe des von hInputBlob bereitgestellten BLOB auf. Beachten Sie, dass alle Fehlercodes, die durch den Aufruf von IDelaydC::Configure zurückgegeben werden, zurückgegeben und vom IDelaydC::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 IDelaydC-Schnittstellenmethoden verwenden müssen, um Frames zu erfassen.

Das vom hInputBlob-Parameter angegebene EingabeBLOB kann durch Aufrufen von GetNPPBlobFromUI, GetNPPBlobTable und SelectNPPBlobFromTable ermittelt 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 Netzwerkmonitor in dem in hInputBlob angegebenen EingabeBLOB nicht verstehen oder finden konnten. Wenn beispielsweise NMERR BLOB ENTRY DOES NOT EXIST zurückgegeben wird, wird der Eintrag, 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

IDelaydC

IDelaydC::Configure

IDelaydC::D isconnect

IDelaydC::Start