Metodo IDebugControl3::GetTextReplacement (dbgeng.h)

Articolo
02/25/2024

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, index viene usato 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. L'indice viene usato solo se SrcText è NULL. L'indice può essere usato insieme a GetNumberTextReplacements per scorrere tutti gli alias denominati dall'utente e automatici.

[out, optional] SrcBuffer

Riceve il nome dell'alias. Si tratta del 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 è stato eseguito correttamente.

Commenti

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