IMonitor::D oConfigure-Methode

Die DoConfigure-Methode muss vom Monitor implementiert werden. McSVC ruft diese Methode auf, um Konfigurationsinformationen für die Erfassung abzurufen.

Syntax

HRESULT STDMETHODCALLTYPE DoConfigure(
  [in]  char *pName,
  [in]  char *pConfiguration,
  [out] char **ppScriptInstance
);

Parameter

pName [ In]

Name einer Instanz des Monitors.

pConfiguration [ In]

Von MCSVC bereitgestellte Konfigurationszeichenfolge. Der Monitor muss diese Zeichenfolge für Konfigurationsdaten analysieren.

ppScriptInstance [ out]

Adresse der HTML-Zeichenfolge, die zum Konfigurieren des Monitors verwendet wird. Wenn ein Standardskript für die Konfiguration verwendet wird, sollte dieser Wert auf NULL festgelegt werden.

Rückgabewert

Wenn die Methode erfolgreich ist, lautet der Rückgabewert S _ OK (entspricht NOERROR), und der MCSVC führt den Monitor aus.

Wenn die Methode nicht erfolgreich ist, ist der Rückgabewert ein Fehlercode. Der Rückgabewert NMERR _ MONITOR _ CONFIG _ FAILED ist akzeptabel. Wenn dieser Fehler zurückgegeben wird, kann der Monitor jedoch erst gestartet werden, wenn ein zukünftiger DoConfigure-Aufruf erfolgreich ist. Jeder andere Fehler verhindert, dass die Instanz des Monitors aktiviert wird.

Hinweise

McSVC ruft diese Methode auf, nachdem eine Verbindung mit dem Netzwerk hergestellt wurde und bevor die IRTC::Configure-Methode aufgerufen wird.

Der Monitor kann die von diesem Aufruf bereitgestellten Informationen speichern, das HTML-Skript oder die Konfigurationszeichenfolge aktualisieren und den Erfassungsfilter im NPP-BLOB festlegen.

McSVC ruft diese Methode möglicherweise mehrmals auf, kann aber nicht aufgerufen werden, während der Monitor Daten erfasst. Beachten Sie, dass jedes Mal, wenn ein NPP eine Erfassung startet, die Verbindung mit dem Netzwerk konfiguriert werden muss. Diese Einschränkung schließt Situationen ein, in denen das NPP die gleiche Erfassung startet und beendet.

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