IDebugControl3::CallExtension method (dbgeng.h)
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 |
|---|---|
|
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) |