Metodo IDebugControl3::GetTextReplacement (dbgeng.h)

Articolo
02/06/2025

Il metodo GetTextReplacement restituisce il valore di un alias denominato dall'utente o di un alias automatico.

Sintassi

HRESULT GetTextReplacement(
  [in, optional]  PCSTR  SrcText,
  [in]            ULONG  Index,
  [out, optional] PSTR   SrcBuffer,
  [in]            ULONG  SrcBufferSize,
  [out, optional] PULONG SrcSize,
  [out, optional] PSTR   DstBuffer,
  [in]            ULONG  DstBufferSize,
  [out, optional] PULONG DstSize
);

Parametri

[in, optional] SrcText

Specifica il nome dell'alias. Il motore cerca prima gli alias denominati dall'utente per uno con questo nome. Quindi, se non viene trovata alcuna corrispondenza, vengono cercati gli alias automatici. Se SrcText è NULL, viene usato index per specificare l'alias.

[in] Index

Specifica l'indice di un alias. Gli indici degli alias denominati dall'utente vengono prima degli indici degli alias automatici. Index viene utilizzato solo se SrcText è null. Index può essere usato insieme a GetNumberTextReplacements per scorrere tutti gli alias automatici e denominati dall'utente.

[out, optional] SrcBuffer

Riceve il nome dell'alias. Questo è il nome specificato in SrcText, se SrcText non è NULL. Se SrcBuffer è null, queste informazioni non vengono restituite.

[in] SrcBufferSize

Specifica le dimensioni, in caratteri, del buffer SrcBuffer.

[out, optional] SrcSize

Riceve le dimensioni, in caratteri, del nome dell'alias. Se SrcSize è null, queste informazioni non vengono restituite.

[out, optional] DstBuffer

Riceve il valore dell'alias specificato da SrcText e Index. Se DstBuffer è null, queste informazioni non vengono restituite.

[in] DstBufferSize

Specifica le dimensioni, in caratteri, del buffer DstBuffer.

[out, optional] DstSize

Riceve le dimensioni, in caratteri, del valore dell'alias. Se DstSize è null, queste informazioni non vengono restituite.

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 SrcBuffer con il valore dell'alias (specificato da DstBuffer).

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.