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

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

통사론

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

[in] SrcText

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

[in, optional] DstText

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

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

반환 코드	묘사
S_OK	메서드가 성공했습니다.

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

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

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

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

요구	값
대상 플랫폼	바탕 화면
헤더	dbgeng.h(Dbgeng.h 포함)

GetTextReplacement

outputTextReplacements

RemoveTextReplacements

SetTextMacro