IDebugControl3::GetWindbgExtensionApis64 方法 (dbgeng.h)

GetWindbgExtensionApis64 方法返回有助于使用 WdbgExts API 的结构。

语法

HRESULT GetWindbgExtensionApis64(
  [in, out] PWINDBG_EXTENSION_APIS64 Api
);

参数

[in, out] Api

接收WINDBG_EXTENSION_APIS64结构。 此结构包含 WdbgExts API 使用的函数。 此结构的 nSize 成员必须设置为结构的大小,然后才能将其传递给此方法。

返回值

此方法也可能返回其他错误值。 有关更多详细信息 ,请参阅返回值

返回代码 说明
S_OK
方法成功。
E_INVALIDARG
Api->nSize 的值不等于结构WINDBG_EXTENSION_APIS64的大小。

注解

如果在扩展代码中包含 Wdbgexts.h,则应在扩展 DLL 初始化期间调用此方法 (请参阅 DebugExtensionInitialize) 。

许多 WdbgExts 函数实际上是宏。 为了确保这些宏正常工作, Api 参数接收的结构应存储在名为 ExtensionApis 的全局变量中。

此方法返回的 WINDBG_EXTENSION_APIS64 结构与 WdbgExts 扩展) 使用的回调函数 WinDbgExtensionDllInit (提供的结构具有相同的目的。

有关 WdbgExts API 提供的函数的列表,请参阅 WdbgExts 函数

要求

要求
目标平台 桌面
标头 dbgeng.h (包括 Wdbgexts.h、Dbgeng.h、Wdbgexts.h)