PDEBUG_EXTENSION_INITIALIZE Rückruffunktion (dbgeng.h)
Die DebugExtensionInitialize-Rückruffunktion wird von der Engine aufgerufen, nachdem eine DbgEng-Erweiterungs-DLL geladen wurde.
CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;
Syntax
PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;
HRESULT PdebugExtensionInitialize(
[out] PULONG Version,
[out] PULONG Flags
)
{...}
Parameter
[out] Version
Empfängt die Version der Erweiterung. Die hohen 16 Bit enthalten die Hauptversionsnummer, und die niedrigen 16 Bits enthalten die Nebenversionsnummer.
[out] Flags
Legen Sie diesen Wert auf 0 fest. (Für zukünftige Verwendung reserviert.)
Rückgabewert
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Erweiterung wurde erfolgreich initialisiert. |
Jeder andere Wert gibt an, dass die Erweiterungs-DLL nicht initialisiert werden konnte und das Modul sie entladen wird.
Hinweise
Die Engine sucht diese Funktion anhand des Namens in jeder Erweiterungs-DLL. Diese Funktion muss von einer DbgEng-Erweiterungs-DLL exportiert werden.
Die Versionsnummer kann mithilfe der Makro-DEBUG_EXTENSION_VERSION in dbgeng.h festgelegt werden, z. B.:
*Version = DEBUG_EXTENSION_VERSION(Major, Minor)
Implementierungen dieser Funktion sollten alle globalen Variablen initialisieren, die für die Erweiterungs-DLL erforderlich sind.
Möglicherweise ist eine Sitzung aktiv, wenn diese Funktion aufgerufen wird. Daher sollte die Erweiterung nicht davon ausgehen, dass sie Sitzungsinformationen abfragen kann.
Der Funktionstyp wird in dbgeng.h als PDEBUG_EXTENSION_INITIALIZE definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | dbgeng.h |