Metodo IDebugControl3::GetTextMacro (dbgeng.h)

Articolo
02/06/2025

Il metodo GetTextMacro restituisce il valore di un alias con 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 a nome fisso. Slot può accettare i valori 0, 1, ..., 9, che rappresentano gli alias a 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 buffer.

[out, optional] MacroSize

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

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

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

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