IStats::Configure-Methode

Die Configure-Methode sendet Konfigurationsinformationen zur Erfassung.

Syntax

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

Parameter

hConfigurationBlob [in]

Behandeln Sie das BLOB, das der Aufrufer konfiguriert.

hErrorBlob [out]

Behandeln Sie ein Fehler-BLOB, 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
Der durch den hConfigurationBlob-Parameter angegebene Konfigurations-BLOB fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Sehen Sie sich den vom hErrorBlob-Parameter zurückgegebenen Fehler-BLOB an, um zu bestimmen, welche Eingabe nicht gefunden wurde.
NMERR_AMBIGUOUS_SPECIFIER
Der BLOB fehlt an 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.

Hinweise

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

Der von hErrorBlob zurückgegebene Fehler-BLOB enthält Einträge, die der Netzwerkmonitor nicht verstehen oder in dem im hConfigurationBlob-Parameter angegebenen Konfigurations-BLOB finden konnte. Der zurückgegebene Fehler-BLOB enthält Fehlerinformationen, die die Anwendung zur Problembehandlung verwenden kann. Wenn beispielsweise NMERR_BLOB_ENTRY_DOES_NOT_EXIST zurückgegeben wird, ist der Eintrag "Netzwerkmonitor" nicht im zurückgegebenen Fehler-BLOB enthalten.

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
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

Siehe auch

IStats

ISTATS::Verbinden

Netzwerküberwachungs-BLOBS