IDelaydC::Connect-Methode
Die Connect-Methode verbindet das NPP über eine angegebene Netzwerkschnittstelle Karte mit dem Netzwerk und stellt Konfigurationsinformationen zur Verbindung bereit.
Syntax
HRESULT STDMETHODCALLTYPE Connect(
[in] HBLOB hInputBlob,
[in] LPVOID StatusCallbackProc,
[in] LPVOID UserContext,
[out] HBLOB hErrorBlob
);
Parameter
-
hInputBlob [in]
-
Verarbeiten Sie das BLOB, das die NIC angibt, mit der Sie eine Verbindung herstellen, und die Konfigurationsinformationen zu dieser Verbindung.
-
StatusCallbackProc [in]
-
Adresse der Rückruffunktion des Benutzers, die verwendet wird, um status Updates wie Trigger zu empfangen. 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 ist, 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 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 IDelaydC::Configure-Aufruf zurückgegeben werden):
Rückgabecode | Beschreibung |
---|---|
|
Diese instance des NPP-COM-Objekts ist bereits mit dem Netzwerk verbunden. |
|
Das Konfigurationsblob ist beschädigt. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert. |
|
Dem von hInputBlob angegebenen Eingabeblob fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Dieser Fehler wird möglicherweise vom IDelaydC::Connect - oder IDelaydC::Configure-Aufruf generiert. Sehen Sie sich den von hErrorBlob zurückgegebenen Fehler blob an, um zu ermitteln, welcher Eintrag nicht gefunden wurde. |
|
Die CreateBlob-Funktion wurde nicht aufgerufen. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert. |
|
Die Zeichenfolge ist nicht NULL-beendet. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert. |
|
Der Triggerteil des Eingabeblobs ist beschädigt. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert. |
|
Das in hInputBlob angegebene Objekt ist kein BLOB. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert. |
|
Das Standarderfassungsverzeichnis wurde in der Registrierung nicht festgelegt. Verwenden Sie den folgenden Pfad, um das Aufzeichnungsverzeichnis festzulegen.
|
|
Für diesen Vorgang war kein Arbeitsspeicher verfügbar. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert. |
|
Für die Anforderung ist ein Timeout aufgetreten. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert. |
|
Die Versionsnummer des in hInputBlob angegebenen BLOB ist falsch. Dieser Fehler wird vom IDelaydC::Configure-Aufruf generiert. |
Bemerkungen
Wenn die Connect-Methode aufgerufen wird, ruft das NPP automatisch IDelaydC::Configure mithilfe des blob auf, das von hInputBlob bereitgestellt wird. Beachten Sie, dass alle Fehlercodes, die vom Aufruf von IDelaydC::Configure zurückgegeben werden, zurückgegeben und vom IDelaydC::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 IDelaydC-Schnittstellenmethoden verwenden müssen, um Frames zu erfassen.
Das durch den hInputBlob-Parameter angegebene Eingabeblob kann durch Aufrufen von 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 |
|
DLL |
|