IRTC::Configure-Methode

Artikel
06/13/2023

Die Configure-Methode übermittelt Konfigurationsdaten für eine Datenerfassung.

Syntax

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

Parameter

hConfigurationBlob [in]: Ein Handle für das BLOB, das vom Aufrufer konfiguriert wird.
hErrorBlob [out]: Ein Handle für ein Fehlerblob, das zusätzliche Fehlerdaten enthält.

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_BLOB_NOT_INITIALIZED	Die CreateBlob-Methode wurde nicht aufgerufen.
NMERR_INVALID_BLOB	Das Objekt, auf das verwiesen wird, ist kein BLOB.
NMERR_UPLEVEL_BLOB	Die BLOB-Versionsnummer ist falsch.
NMERR_BLOB_ENTRY_ALREADY_EXISTS	Doppeltes BLOB.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Dem von hConfigurationBlob angegebenen Konfigurationsblob fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Zeigen Sie den von hErrorBlob zurückgegebenen Fehler BLOB an, um zu ermitteln, welcher Eintrag nicht gefunden wurde.
NMERR_AMBIGUOUS_SPECIFIER	Die Blobbesitzer- oder Kategoriedaten fehlen.
NMERR_BLOB_OWNER_NOT_FOUND	Der Abschnitt BLOB-Besitzer wurde nicht gefunden.
NMERR_BLOB_CATEGORY_NOT_FOUND	Der Abschnitt BLOB-Kategorie wurde nicht gefunden.
NMERR_UNKNOWN_CATEGORY	Der Abschnitt BLOB-Kategorie wurde gefunden, aber nicht verstanden.
NMERR_UNKNOWN_TAG	Der Abschnitt BLOB-Tag wurde gefunden, aber nicht verstanden.
NMERR_BLOB_CONVERSION_ERROR	Das BLOB ist beschädigt.
NMERR_ILLEGAL_TRIGGER	Der Triggerteil des BLOB ist beschädigt.
NMERR_BLOB_STRING_INVALID	Die Zeichenfolge ist nicht NULL-beendet.

Bemerkungen

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

Das von hErrorBlob 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 Fehlerdaten, 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

Weitere Informationen

IRTC
IRTC::Connect
Netzwerkmonitor-BLOBS

Freigeben über