IESP::Configure-Methode

Artikel
06/13/2023

Die Configure-Methode übermittelt Konfigurationsinformationen für eine Erfassung.

Syntax

HRESULT STDMETHODCALLTYPE Configure(
  [in]  HBLOB hConfigurationBlob,
  [out] HBLOB hErrorBlob
);

Parameter

hConfigurationBlob [in]: Handle mit dem BLOB, das der Aufrufer konfiguriert.
hErrorBlob [out]: Behandeln sie ein Fehlerblob, das zusätzliche Fehlerinformationen enthält. Informationen zum Inhalt eines Fehlerblobs finden Sie im Abschnitt Hinweise in diesem Thema.

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:

Rückgabecode	Beschreibung
NMERR_NOT_CONNECTED	Das NPP ist nicht mit dem Netzwerk verbunden.
NMERR_NOT_ESP	Das NPP ist mit dem Netzwerk verbunden, jedoch nicht mit der IESP::Connect-Methode .
NMERR_CAPTURING	Das NPP meldet, dass die Erfassungssitzung gestartet wurde.
NMERR_ILLEGAL_TRIGGER	Der Triggerteil des Konfigurationsblobs ist beschädigt.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Dem von hConfigurationBlob angegebenen Konfigurationsblob fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Sehen Sie sich den von hErrorBlob zurückgegebenen Fehler blob an, um zu ermitteln, welcher Eintrag nicht gefunden wurde.
NMERR_BLOB_CONVERSION_ERROR	Das BLOB ist beschädigt.
NMERR_BLOB_NOT_INITIALIZED	Die CreateBlob-Methode wurde nicht aufgerufen.
NMERR_INVALID_BLOB	Das Objekt, auf das verwiesen wird, ist kein BLOB.
NMERR_BLOB_STRING_INVALID	Die Zeichenfolge ist nicht NULL-beendet.
NMERR_UPLEVEL_BLOB	Die BLOB-Versionsnummer ist falsch.
NMERR_OUT_OF_MEMORY	Es war kein Arbeitsspeicher verfügbar. Schließen Sie Fenster, um Ressourcen freizugeben.
NMERR_TIMEOUT	Timeout für die Anforderung.

Bemerkungen

Sie müssen diese Methode anwenden, um ein NPP neu zu starten, das gestartet und beendet wurde, aber nicht getrennt wurde.

Das vom hErrorBlob-Parameter zurückgegebene Fehlerblob enthält Einträge, die der Netzwerkmonitor in dem in hConfigurationBlob angegebenen Konfigurationsblob nicht verstehen oder 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 Netzwerkmonitor nicht gefunden im zurückgegebenen Fehler BLOB enthalten.

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

Teilen über