IDebugControl3::CallExtension method (dbgeng.h)

Article
02/22/2024

The CallExtension method calls a debugger extension.

Syntax

HRESULT CallExtension(
  [in]           ULONG64 Handle,
  [in]           PCSTR   Function,
  [in, optional] PCSTR   Arguments
);

Parameters

[in] Handle

Specifies the handle of the extension library that contains the extension to call. If Handle is zero, the engine will walk the extension library chain searching for the extension.

[in] Function

Specifies the name of the extension to call.

[in, optional] Arguments

Specifies the arguments to pass to the extension. Arguments is a string that will be parsed by the extension, just like the extension will parse arguments passed to it when called as an extension command.

Return value

Return code	Description
S_OK	The method was successful.

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

Remarks

If Handle is zero, the engine searches each extension library until it finds one that contains the extension; the extension will then be called. If the extension returns DEBUG_EXTENSION_CONTINUE_SEARCH, the search will continue.

For more information on using extension libraries, see Calling Extensions and Extension Functions.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)