IDebugControl2::GetTextReplacement 메서드(dbgeng.h)

GetTextReplacement 메서드는 사용자 이름 별칭 또는 자동 별칭의 값을 반환합니다.

구문

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

매개 변수

[in, optional] SrcText

별칭의 이름을 지정합니다. 엔진은 먼저 사용자 이름이 지정된 별칭에서 이 이름을 가진 별칭을 검색합니다. 그런 다음 일치하는 항목이 없으면 자동 별칭이 검색됩니다. SrcTextNULL이면 인덱스를 사용하여 별칭을 지정합니다.

[in] Index

별칭의 인덱스를 지정합니다. 사용자 이름 별칭의 인덱스는 자동 별칭의 인덱스 앞에 옵니다. 인덱 스는 SrcTextNULL인 경우에만 사용됩니다. 인덱 스는 GetNumberTextReplacements 와 함께 사용하여 모든 사용자 이름 및 자동 별칭을 반복할 수 있습니다.

[out, optional] SrcBuffer

별칭의 이름을 받습니다. SrcTextNULL이 아닌 경우 SrcText에 지정된 이름입니다. SrcBufferNULL이면 이 정보가 반환되지 않습니다.

[in] SrcBufferSize

SrcBuffer 버퍼의 크기를 문자 단위로 지정합니다.

[out, optional] SrcSize

별칭 이름의 크기를 문자 단위로 받습니다. SrcSizeNULL이면 이 정보가 반환되지 않습니다.

[out, optional] DstBuffer

SrcTextIndex에서 지정한 별칭의 값을 받습니다. DstBufferNULL이면 이 정보가 반환되지 않습니다.

[in] DstBufferSize

DstBuffer 버퍼의 크기를 문자 단위로 지정합니다.

[out, optional] DstSize

별칭 값의 크기를 문자 단위로 받습니다. DstSizeNULL이면 이 정보가 반환되지 않습니다.

반환 값

이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값을 참조하세요 .

반환 코드 Description
S_OK
메서드를 성공적으로 수행했습니다.

설명

명령을 실행하거나 식을 평가하기 전에 디버거 엔진은 SrcBuffer 에서 지정한 별칭을 별칭 값( DstBuffer로 지정됨)으로 바꿉니다.

디버거 엔진에서 사용하는 별칭에 대한 개요는 별칭 사용을 참조하세요. 디버거 엔진 API에서 별칭을 사용하는 방법에 대한 자세한 내용은 엔진과 상호 작용을 참조하세요.

요구 사항

요구 사항
대상 플랫폼 데스크톱
머리글 dbgeng.h(Dbgeng.h 포함)

추가 정보

GetNumberTextReplacements

GetTextMacro

IDebugControl2

IDebugControl3

OutputTextReplacements

SetTextReplacement

al(별칭 나열)