IDebugControl3::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
별칭의 이름을 지정합니다. 엔진은 먼저 사용자 이름 별칭에서 이 이름을 가진 별칭을 검색합니다. 그런 다음 일치하는 항목이 없으면 자동 별칭이 검색됩니다. SrcText가 NULL인 경우 인덱스는 별칭을 지정하는 데 사용됩니다.
[in] Index
별칭의 인덱스를 지정합니다. 사용자 이름 별칭의 인덱스는 자동 별칭의 인덱스 앞에 옵니다. 인덱 스는 SrcText 가 NULL인 경우에만 사용됩니다. 인덱 스를 GetNumberTextReplacements 와 함께 사용하여 모든 사용자 이름 및 자동 별칭을 반복할 수 있습니다.
[out, optional] SrcBuffer
별칭의 이름을 받습니다. SrcText가 NULL이 아닌 경우 SrcText에 지정된 이름입니다. SrcBuffer가 NULL이면 이 정보가 반환되지 않습니다.
[in] SrcBufferSize
SrcBuffer 버퍼의 크기를 문자 단위로 지정합니다.
[out, optional] SrcSize
별칭 이름의 크기를 문자 단위로 받습니다. SrcSize가 NULL이면 이 정보가 반환되지 않습니다.
[out, optional] DstBuffer
SrcText 및 Index에서 지정한 별칭의 값을 받습니다. DstBuffer가 NULL이면 이 정보가 반환되지 않습니다.
[in] DstBufferSize
DstBuffer 버퍼의 크기를 문자 단위로 지정합니다.
[out, optional] DstSize
별칭 값의 크기를 문자 단위로 받습니다. DstSize가 NULL이면 이 정보가 반환되지 않습니다.
반환 값
이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값을 참조하세요.
반환 코드 | Description |
---|---|
|
메서드를 성공적으로 수행했습니다. |
설명
명령을 실행하거나 식을 평가하기 전에 디버거 엔진은 SrcBuffer 에 지정된 별칭을 별칭 값( DstBuffer로 지정됨)으로 바꿉니다.
디버거 엔진에서 사용하는 별칭에 대한 개요는 별칭 사용을 참조하세요. 디버거 엔진 API에서 별칭을 사용하는 방법에 대한 자세한 내용은 엔진과 상호 작용을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 데스크톱 |
머리글 | dbgeng.h(Dbgeng.h 포함) |