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 |
|---|---|
|
Die CreateBlob-Methode wurde nicht aufgerufen. |
|
Das Objekt, auf das gezeigt wird, ist kein BLOB. |
|
Die BLOB-Versionsnummer ist falsch. |
|
Doppeltes BLOB. |
|
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. |
|
Die Blobbesitzer- oder Kategoriedaten fehlen. |
|
Der Abschnitt BLOB-Besitzer wurde nicht gefunden. |
|
Der Abschnitt BLOB-Kategorie wurde nicht gefunden. |
|
Der Abschnitt BLOB-Kategorie wurde gefunden, aber nicht verstanden. |
|
Der Abschnitt BLOB-Tag wurde gefunden, aber nicht verstanden. |
|
Das BLOB ist beschädigt. |
|
Der Triggerteil des BLOB ist beschädigt. |
|
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 |
|
| DLL |
|