Compartilhar via


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

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. slot pode levar 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 do buffer de.

[out, optional] MacroSize

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

Valor de retorno

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

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

Observações

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 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.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

GetNumberTextReplacements

GetTextReplacement

IDebugControl

IDebugControl2

IDebugControl3

SetTextMacro

r (Registros)