DllMain Parser-Rückruffunktion

Die DllMain-Exportfunktion für den Parser identifiziert das Vorhandensein des Parsers und gibt Ressourcen frei, die der Netzwerkmonitor für den Parser verwendet. DllMain muss in allen Parser-DLLs implementiert werden.

Syntax

BOOL WINAPI DllMain(
  _In_ HANDLE hInstance,
  _In_ ULONG  Command,
       LPVOID Reserved
);

Parameter

hInstance [in]

Handle mit einer instance des Parsers.

Befehl [in]

Indikator, um zu bestimmen, warum die Funktion aufgerufen wird. Eine Liste aller möglichen Flags finden Sie unter DllMain. Die Parserimplementierung muss die folgenden Werte verarbeiten.

Wert	Bedeutung
DLL_PROCESS_ATTACH	Wenn DllMain zum ersten Mal aufgerufen wird, muss die DLL CreateProtocol aufrufen, um Informationen für den Netzwerkmonitor bereitzustellen.
DLL_PROCESS_DETACH	Wenn DllMain zum letzten Mal aufgerufen wird, muss die DLL DestroyProtocol aufrufen, um die ressourcen freizugeben, die die DLL verwendet.

Reserved

Wird jetzt nicht verwendet.

Rückgabewert

Die Parser-DLL gibt immer TRUE zurück.

Bemerkungen

Das Betriebssystem ruft DllMain auf, um die Parser-DLL zu laden und zu entladen. Diese Funktion basiert auf der DllMain-Funktion der Dynamic Link Library.

Sie können die Implementierung von DllMain auch verwenden, um eine instance eines Parsers für die zukünftige Verwendung zu speichern. Sie können beispielsweise eine Parser-DLL instance speichern und diese dann für einen zukünftigen Systemaufruf verwenden.

Für Informationen zu	Siehe
Was Parser sind und wie sie mit Dem Netzwerkmonitor funktionieren.	Parser
Welche Einstiegspunkte sind in der Parser-DLL enthalten?	Parser-DLL-Architektur
Die Implementierung von DllMain enthält ein Beispiel.	Implementieren von DllMain

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Process.h

Siehe auch

CreateProtocol

DestroyProtocol

DllMain