IESP::Configure-Methode

Die Configure-Methode übermittelt Konfigurationsinformationen für eine Erfassung.

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. Informationen zum Inhalt eines Fehlerblobs finden Sie im Abschnitt "Hinweise" in diesem Thema.

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 _ NICHT _ VERBUNDEN
Der NPP ist nicht mit dem Netzwerk verbunden.
NMERR _ NICHT _ ESP
Das NPP ist mit dem Netzwerk verbunden, aber nicht mit der IESP::Verbinden-Methode.
NMERR-ERFASSUNG _
Der NPP meldet, dass die Erfassungssitzung gestartet wurde.
NMERR– _ UNZULÄSSIGER _ TRIGGER
Der Triggerteil des Konfigurationsblobs ist beschädigt.
_NMERR-BLOBEINTRAG _ IST NICHT _ _ _ VORHANDEN
Dem von hConfigurationBlob angegebenen Konfigurationsblob fehlt ein Eintrag, der zum Ausführen dieses Vorgangs erforderlich ist. Sehen Sie sich den von hErrorBlob zurückgegebenen FehlerBLOB an, um zu ermitteln, welcher Eintrag nicht gefunden wurde.
_ _ NMERR-BLOBKONVERTIERUNGSFEHLER _
Das BLOB ist beschädigt.
_NMERR-BLOB _ NICHT _ INITIALISIERT
Die CreateBlob-Methode wurde nicht aufgerufen.
NMERR _ INVALID _ BLOB
Das Objekt, auf das verwiesen wird, ist kein BLOB.
NMERR-BLOBZEICHENFOLGE _ _ _ UNGÜLTIG
Die Zeichenfolge wird nicht mit NULL beendet.
NMERR _ UPLEVEL _ BLOB
Die BLOB-Versionsnummer ist falsch.
NMERR _ NICHT _ GENÜGEND _ ARBEITSSPEICHER
Es war kein Arbeitsspeicher verfügbar. Fahren Sie Fenster herunter, um Ressourcen frei zu machen.
_NMERR-TIMEOUT
Timeout für die Anforderung.

Bemerkungen

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

Das vom hErrorBlob-Parameter zurückgegebene FehlerBLOB enthält Einträge, die Netzwerkmonitor in dem in hConfigurationBlob angegebenen KonfigurationsBLOB 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