다음을 통해 공유


IDebugControl3::SetTextReplacement 메서드(dbgeng.h)

SetTextReplacement 메서드는 사용자 이름 별칭의 값을 설정합니다.

구문

HRESULT SetTextReplacement(
  [in]           PCSTR SrcText,
  [in, optional] PCSTR DstText
);

매개 변수

[in] SrcText

사용자 이름 별칭의 이름을 지정합니다. 디버거 엔진은 이 문자열의 복사본을 만듭니다. SrcText가 자동 별칭의 이름과 같으면 새 사용자 이름 별칭으로 자동 별칭이 숨겨집니다.

[in, optional] DstText

사용자 이름 별칭의 값을 지정합니다. 디버거 엔진은 이 문자열의 복사본을 만듭니다. DstTextNULL이면 사용자 이름 별칭이 제거됩니다.

반환 값

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

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

설명

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

SrcText가 별표(*)이고 DstTextNULL이면 모든 사용자 이름 별칭이 제거됩니다. 이는 RemoveTextReplacements 메서드와 동일한 동작입니다.

이 메서드에서 별칭을 변경하면 이벤트 콜백은 DEBUG_CES_TEXT_REPLACEMENTS 플래그를 IDebugEventCallbacks::ChangeEngineState 콜백 메서드에 전달하여 알림을 받습니다.

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

요구 사항

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

추가 정보

GetTextReplacement

IDebugControl2

IDebugControl3

OutputTextReplacements

RemoveTextReplacements

SetTextMacro

광고(별칭 삭제)

as, aS(별칭 설정)