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 |
|---|---|
|
Diese Instanz des NPP-COM-Objekts ist bereits mit dem Netzwerk verbunden. |
|
Das Konfigurationsblob ist beschädigt. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert. |
|
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. |
|
Die CreateBlob-Funktion wurde nicht aufgerufen. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert. |
|
Die Zeichenfolge wird nicht mit NULL beendet. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert. |
|
Der Triggerteil des Eingabeblobs ist beschädigt. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert. |
|
Das in hInputBlob angegebene Objekt ist kein BLOB. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert. |
|
Das Standarderfassungsverzeichnis wurde in der Registrierung nicht festgelegt. Verwenden Sie den folgenden Pfad zum Festlegen des Erfassungsverzeichnisses. |
|
Der zum Ausführen dieses Vorgangs benötigte Arbeitsspeicher ist nicht verfügbar. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert. |
|
Für die Anforderung ist ein Time out erfolgt. Dieser Fehler wird durch den IESP::Configure-Aufruf generiert. |
|
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 |
|
| DLL |
|