PDEBUG_EXTENSION_INITIALIZE回调函数（dbgeng.h）

DebugExtensionInitialize 回调函数在加载 DbgEng 扩展 DLL 后由引擎调用。

 CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;

语法

PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;

HRESULT PdebugExtensionInitialize(
  [out] PULONG Version,
  [out] PULONG Flags
)
{...}

[out] Version

接收扩展的版本。高 16 位包含主要版本号，低 16 位包含次要版本号。

[out] Flags

将此设置为零。（保留供将来使用。

返回代码	描述
S_OK	扩展已成功初始化。

任何其他值都指示扩展 DLL 无法初始化，并且引擎将卸载它。

引擎在每个扩展 DLL 中按名称查找此函数。此函数必须由 DbgEng 扩展 DLL 导出。

可以使用 dbgeng.h 中找到的宏DEBUG_EXTENSION_VERSION设置版本号，例如：

*Version = DEBUG_EXTENSION_VERSION(Major, Minor)

此函数的实现应初始化扩展 DLL 所需的任何全局变量。

调用此函数时，可能没有活动会话，因此扩展不应假定它能够查询会话信息。

函数类型在 dbgeng.h 中定义为PDEBUG_EXTENSION_INITIALIZE。

要求	价值
目标平台	普遍
标头	dbgeng.h