Поделиться через


Метод IDebugControl3::GetWindbgExtensionApis64 (dbgeng.h)

Метод GetWindbgExtensionApis6 4 возвращает структуру, которая упрощает использование API WdbgExts.

Синтаксис

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

Параметры

[in, out] Api

Получает WINDBG_EXTENSION_APIS64 структуру. Эта структура содержит функции, используемые API WdbgExts. Элемент nSize этой структуры должен быть установлен на размер структуры, прежде чем он передается этому методу.

Возвращаемое значение

Этот метод также может возвращать другие значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Возвращаемый код Описание
S_OK
Метод был успешным.
E_INVALIDARG
Значение Api->nSize не равно размеру WINDBG_EXTENSION_APIS64 структуры.

Замечания

Если вы включаете Wdbgexts.h в код расширения, необходимо вызвать этот метод во время инициализации библиотеки DLL расширения (см. раздел DebugExtensionInitialize).

Многие функции WdbgExts — это действительно макросы. Чтобы эти макросы работали правильно, структура, полученная параметром api api, должна храниться в глобальной переменной с именем ExtensionAp is.

Структура WINDBG_EXTENSION_APIS64, возвращаемая этим методом, служит той же цели, что и функция обратного вызова WinDbgExtensionDllInit (используется расширениями WdbgExts).

Список функций, предоставляемых API WdbgExts, см. в разделе функции WdbgExts.

Требования

Требование Ценность
целевая платформа Настольный
заголовка dbgeng.h (include Wdbgexts.h, Dbgeng.h, Wdbgexts.h)