IStats::Configure-Methode

Die Configure-Methode übermittelt Informationen zur Erfassungskonfiguration.

Syntax

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

Parameter

hConfigurationBlob [ In]

Handle für das BLOB, das der Aufrufer konfiguriert.

hErrorBlob [ out]

Handle für ein Fehlerblob, das zusätzliche Fehlerinformationen enthält.

Rückgabewert

Wenn die Methode erfolgreich ist, ist der Rückgabewert NMERR _ SUCCESS.

Wenn die Methode nicht erfolgreich ist, ist der Rückgabewert einer der folgenden Fehlercodes:

Rückgabecode Beschreibung
NMERR-BLOBZEICHENFOLGE _ _ _ UNGÜLTIG
Die Zeichenfolge wird nicht mit NULL beendet.
_NMERR-BLOB _ NICHT _ INITIALISIERT
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-BLOBEINTRAG _ _ BEREITS _ _ VORHANDEN
Ein BLOB-Eintrag ist bereits vorhanden.
_NMERR-BLOBEINTRAG _ IST NICHT _ _ _ VORHANDEN
Für das vom hConfigurationBlob-Parameter angegebene Konfigurationsblob fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Sehen Sie sich den Vom hErrorBlob-Parameter zurückgegebenen FehlerBLOB an, um zu ermitteln, welcher Eintrag nicht gefunden wurde.
_NMERR-MEHRDEUTIGER _ SPEZIFIZIERER
Im BLOB fehlen Besitzer- oder Kategorieinformationen.
NMERR _ BLOB OWNER NOT FOUND (NMERR-BLOBBESITZER NICHT _ _ _ GEFUNDEN)
Der Abschnitt Besitzer des BLOB wurde nicht gefunden.
_NMERR-BLOBKATEGORIE _ _ NICHT _ GEFUNDEN
Der Abschnitt Category des BLOB wurde nicht gefunden.
NMERR _ UNKNOWN _ CATEGORY
Kategorieinformationen wurden gefunden, aber nicht verstanden.
NMERR _ UNKNOWN _ TAG
Taginformationen wurden gefunden, aber nicht verstanden.
_ _ NMERR-BLOBKONVERTIERUNGSFEHLER _
Das BLOB ist beschädigt.
NMERR– _ UNZULÄSSIGER _ 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 Netzwerkmonitor im KonfigurationsBLOB, das im hConfigurationBlob-Parameter angegeben ist, nicht verstehen oder finden konnten. 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, wird der Netzwerkmonitor, der nicht finden konnte, _ _ in das zurückgegebene _ _ FehlerBLOB _ eingeschlossen.

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

Weitere Informationen

IStats

ISTATS::Verbinden

Netzwerkmonitor BLOBS