Método IDebugControl3::GetTextMacro (dbgeng.h)

Artigo
02/26/2024

O método GetTextMacro retorna o valor de um alias de nome fixo.

Sintaxe

HRESULT GetTextMacro(
  [in]            ULONG  Slot,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG MacroSize
);

Parâmetros

[in] Slot

Especifica o número do alias de nome fixo. O slot pode obter os valores 0, 1, ..., 9, que representam os aliases de nome fixo $u 0, $u 1, ..., $u 9.

[out, optional] Buffer

Recebe o valor do alias especificado por Slot. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho, em caracteres, do buffer de buffer .

[out, optional] MacroSize

Recebe o tamanho, em caracteres, do valor do alias.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Antes de executar comandos ou avaliar expressões, o mecanismo de depurador substituirá o alias especificado por Slot pelo valor do alias (retornado ao buffer buffer ).

Para obter uma visão geral dos aliases usados pelo mecanismo de depurador, consulte Usando aliases. Para obter mais informações sobre como usar aliases com a API do mecanismo de depurador, consulte Interação com o Mecanismo.