Metodo IDebugControl3::GetTextMacro (dbgeng.h)

Articolo
08/07/2023

Il metodo GetTextMacro restituisce il valore di un alias a 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. Lo 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 .

[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 è 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 di debugger, vedere Uso degli alias. Per altre informazioni sull'uso di alias con l'API del motore di debugger, vedere Interazione con il motore.