IDebugControl::GetWindbgExtensionApis32 method (dbgeng.h)

The GetWindbgExtensionApis32 method returns a structure that facilitates using the WdbgExts API.

Syntax

HRESULT GetWindbgExtensionApis32(
  [in, out] PWINDBG_EXTENSION_APIS32 Api
);

Parameters

[in, out] Api

Receives a WINDBG_EXTENSION_APIS32 structure. This structure contains the functions used by the WdbgExts API. The nSize member of this structure must be set to the size of the structure before it is passed to this method.

Return value

This method may also return other error values. See Return Values for more details.

Return code Description
S_OK
The method was successful.
E_INVALIDARG
The value of Api->nSize does not equal the size of the structure WINDBG_EXTENSION_APIS32.

Remarks

If you are including Wdbgexts.h in your extension code, you should call this method during the initialization of the extension DLL (see DebugExtensionInitialize).

Many WdbgExts functions are really macros. To ensure that these macros work correctly, the structure received by the Api parameter should be stored in a global variable named ExtensionApis.

For a list of the functions provided by the WdbgExts API, see WdbgExts Functions.

Requirements

Requirement Value
Target Platform Windows
Header dbgeng.h

See also

DebugExtensionInitialize

IDebugControl

IDebugControl2

IDebugControl3

WdbgExts Functions