Metodo IDebugControl2::GetTextMacro (dbgeng.h)

Articolo
02/23/2024

Il metodo GetTextMacro restituisce il valore di un alias di nome fisso.

Sintassi

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

Parametri

[in] Slot

Specifica il numero dell'alias nome fisso. Lo slot può accettare i valori 0, 1, ..., 9, che rappresentano gli alias di nome fisso $u 0, $u 1, ..., $u 9.

[out, optional] Buffer

Riceve il valore dell'alias specificato da Slot. Se buffer è NULL, queste informazioni non vengono restituite.

[in] BufferSize

Specifica le dimensioni, in caratteri , del buffer buffer.

[out, optional] MacroSize

Riceve le dimensioni, in caratteri, del valore dell'alias.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Prima di eseguire comandi o valutare espressioni, il motore del debugger sostituirà l'alias specificato da Slot con il valore dell'alias (restituito al buffer buffer ).

Per una panoramica degli alias usati dal motore del debugger, vedere Uso di alias. Per altre informazioni sull'uso di alias con l'API del motore di debugger, vedere Interazione con il motore.