IDebugControl3::SetTextMacro method (dbgeng.h)

Article
02/22/2024

The SetTextMacro method sets the value of a fixed-name alias.

Syntax

HRESULT SetTextMacro(
  [in] ULONG Slot,
  [in] PCSTR Macro
);

Parameters

[in] Slot

Specifies the number of the fixed-name alias. Slot can take the values 0, 1, ..., 9, that represent the fixed-name aliases $u0, $u1, ..., $u9.

[in] Macro

Specifies the new value of the alias specified by Slot. The debugger engine makes a copy of this string.

Return value

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

Return code	Description
S_OK	The method was successful.

Remarks

Before executing commands or evaluating expressions, the debugger engine will replace the alias specified by Slot with the value of the alias (specified by Macro).

For an overview of aliases used by the debugger engine, see Using Aliases. For more information about using aliases with the debugger engine API, see Interacting with the Engine.

Requirements

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