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

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

구문

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

[in] SrcText

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

[in, optional] DstText

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

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

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

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

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

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

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

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