IStats::Configure-Methode

Artikel
06/13/2023

Die Configure-Methode übermittelt Erfassungskonfigurationsinformationen.

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.

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_STRING_INVALID	Die Zeichenfolge ist nicht NULL-beendet.
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	Ein BLOB-Eintrag ist bereits vorhanden.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Dem Konfigurationsblob, das durch den hConfigurationBlob-Parameter angegeben wird, fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Sehen Sie sich den Fehler BLOB an, der vom hErrorBlob-Parameter zurückgegeben wird, um zu ermitteln, welcher Eintrag nicht gefunden wurde.
NMERR_AMBIGUOUS_SPECIFIER	Dem BLOB fehlen Besitzer- oder Kategorieinformationen.
NMERR_BLOB_OWNER_NOT_FOUND	Der Abschnitt Besitzer des BLOB wurde nicht gefunden.
NMERR_BLOB_CATEGORY_NOT_FOUND	Der Abschnitt Kategorie des BLOB wurde nicht gefunden.
NMERR_UNKNOWN_CATEGORY	Kategorieinformationen wurden gefunden, aber nicht verstanden.
NMERR_UNKNOWN_TAG	Taginformationen wurden gefunden, aber nicht verstanden.
NMERR_BLOB_CONVERSION_ERROR	Das BLOB ist beschädigt.
NMERR_ILLEGAL_TRIGGER	Der Triggerteil des BLOB ist beschädigt.

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 im hConfigurationBlob-Parameter 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

Weitere Informationen

IStats
ISTATS::Connect
Netzwerkmonitor-BLOBS

Freigeben über