IRTC::Configure-Methode

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 Fehler-BLOB, das zusätzliche Fehlerdaten enthält.

Rückgabewert

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

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

Rückgabecode Beschreibung
_NMERR-BLOB _ NICHT _ INITIALISIERT
Die CreateBlob-Methode wurde nicht aufgerufen.
NMERR _ UNGÜLTIGES _ BLOB
Das Objekt, auf das gezeigt wird, ist kein BLOB.
_ _ NMERR-UPLEVEL-BLOB
Die BLOB-Versionsnummer ist falsch.
_NMERR-BLOBEINTRAG _ IST BEREITS _ _ VORHANDEN
Doppeltes BLOB.
NMERR _ BLOB ENTRY DOES NOT EXIST (NMERR-BLOBEINTRAG IST NICHT _ _ _ _ VORHANDEN)
Dem von hConfigurationBlob angegebenen Konfigurations-BLOB fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Zeigen Sie das von hErrorBlob zurückgegebene Fehlerblob an, um zu ermitteln, welcher Eintrag nicht gefunden wurde.
NMERR _ AMBIGUOUS _ SPECIFIER
Die Blobbesitzer- oder Kategoriedaten fehlen.
_NMERR-BLOBBESITZER _ _ NICHT _ GEFUNDEN
Der Abschnitt BLOB-Besitzer wurde nicht gefunden.
_NMERR-BLOBKATEGORIE _ _ NICHT _ GEFUNDEN
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-BLOBKONVERTIERUNGSFEHLER _
Das BLOB ist beschädigt.
NMERR _ ILLEGAL _ TRIGGER
Der Triggerteil des BLOB ist beschädigt.
NMERR _ BLOB _ STRING _ INVALID
Die Zeichenfolge ist nicht NULL-terminiert.

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 nicht verstehen oder im Konfigurations-BLOB finden konnten, das in hConfigurationBlob angegeben ist. Das zurückgegebene Fehlerblob enthält Fehlerdaten, die die Anwendung für die Problembehandlung verwenden kann. Wenn z. B. NMERR _ BLOB ENTRY DOES NOT EXIST zurückgegeben _ _ _ _ wird, ist der Eintrag, den Netzwerkmonitor nicht finden kann, im zurückgegebenen Fehlerblob 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

Weitere Informationen

IRTC

IRTC::Verbinden

Netzwerkmonitor BLOBS