OnLoadingDLL-Funktion

Die OnLoadingDLL-Funktion lädt die Monitor-DLL.

Syntax

HRESULT OnLoadingDLL(
  _Inout_ HBLOB hFilterBlob,
  _In_    DWORD *pCreateFlags,
  _Out_   char  **ppDefaultName,
  _Out_   char  **ppDescription,
  _Out_   char  **ppDefaultScript,
  _Out_   char  **ppDefaultConfig
);

Parameter

hFilterBlob [ in, out]

Ein BLOB, das mcsvc verwendet, um einen Monitor mit verfügbaren NICs abzugleichen. Dieser Parameter enthält immer eine Anforderung für eine IRTC-Schnittstelle, sodass die meisten Monitore dem BLOB keine Einträge hinzufügen müssen. Ein benutzerdefinierter Monitor kann jedoch zusätzliche Filterkriterien hinzufügen (z. B. dass der MAC-Typ Ethernet sein muss).

pCreateFlags [ In]

Die Flags, die angeben, wie MCSVC die Erstellung eines Monitors steuert. Dieser Parameter muss einen der folgenden Werte aufweisen:

Wert Bedeutung
MCS _ CREATE _ ONE _ PER _ NETCARD
McSVC stellt sicher, dass für jede NIC nur eine Instanz dieses Monitors vorhanden ist. Eine zweite Instanz kann nur erstellt werden, wenn die erste instanz zerstört wird.
MCS _ CREATE _ CONFIGS _ BY _ DEFAULT
Wenn der Monitor über eine interne Standardkonfiguration verfügt, erfordert MCSVC nicht, dass der Benutzer den Monitor konfiguriert, bevor die Instanz erstellt wird.

ppDefaultName [ out]

Ein Zeiger auf einen Zeiger auf die Adresse des Standardnamens des Monitors. McSVC verwendet beim Erstellen von Instanzen des Monitors den Standardnamen.

Wenn der zurückgegebene Standardname beispielsweise "Routermonitor" lautet, lautet die erste Überwachungsinstanz "Routermonitor 1", die zweite "RouterMonitor2" usw. Wenn NULL zurückgegeben wird, verwendet MCSVC den Namen der DLL.

ppDescription [ out]

Ein Zeiger auf einen Zeiger auf die Adresse der Beschreibung des Monitors. Die Beschreibung wird an das Monitorsteuerungstool übergeben, das die Beschreibung verwendet, um dem Benutzer anzugeben, dass der Monitor vorhanden ist. Dieser Parameter kann NULL zurückgeben.

ppDefaultScript [ out]

Ein Zeiger auf einen Zeiger auf die Adresse des HTML-Standardformularskripts, das zum Konfigurieren des Monitors verwendet wird. Obwohl die Instanzen des Monitors ihr eigenes Skript ändern können, laden die meisten Monitore ihr Skript einfach einmal aus einer Datei. Der Wert von ppDefaultScript kann NULL sein. dann kann der Monitor jedoch nicht extern konfiguriert werden, oder er muss später ein Skript bereitstellen. Es ist effizienter, hier ein Standardskript zur Verfügung zu stellen.

ppDefaultConfig [ out]

Die Adresse der Standardzeichenfolge, die verwendet wird, um den Monitor beim Erstellen zu konfigurieren. Dieser Parameter kann auf NULL festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, lautet der Rückgabewert S OK. Dies _ entspricht NOERROR.

Wenn die Funktion nicht erfolgreich ist, lässt MCSVC den angegebenen Monitor aus allen Listen aus. danach kann kein Monitor dieses Typs erstellt werden.

Hinweise

Die OnLoadingDLL-Funktion wird einmal von MCSVC aufgerufen, wenn sie zum ersten Mal die DLL lädt. Die DLL stellt dann die Standardwerte bereit, die von MCSVC beim Erstellen einer Instanz eines Monitors verwendet werden.

Der Monitor muss den gesamten erforderlichen Arbeitsspeicher für die Zeichenfolgen zuordnen, die an MCSVC zurückgegeben werden. Bei der Rückgabe kopiert MCSVC alle Zeichenfolgen und versucht nicht, die zurückgegebenen Zeichenfolgen frei zu geben.

Der Monitor sollte BLOB-Hilfsfunktionen verwenden, um das Filterblob zu ändern.

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