IStats::Configure-Methode

  • Artikel

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