IDebugDataSpaces4::ReadUnicodeStringVirtual 메서드(dbgeng.h)

아티클
02/06/2022
읽는 데 2분 걸림

ReadUnicodeStringVirtual 메서드는 대상에서 null로 종료된 유니코드 문자열을 읽고 멀티바이트 문자열로 변환합니다.

구문

HRESULT ReadUnicodeStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [in]            ULONG   CodePage,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  StringBytes
);

매개 변수

[in] Offset

문자열의 프로세스 가상 주소 공간에 있는 위치를 지정합니다.

[in] MaxBytes

대상에서 읽을 최대 바이트 수를 지정합니다.

[in] CodePage

대상에서 읽은 멀티 바이트 문자열을 유니코드 문자열로 변환하는 데 사용할 코드 페이지를 지정합니다. 예를 들어 CP_ACP ANSI 코드 페이지입니다.

[out, optional] Buffer

대상에서 문자열을 받습니다. Buffer가 NULL이면 이 정보가 반환되지 않습니다.

[in] BufferSize

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

[out, optional] StringBytes

대상에 있는 문자열의 크기(바이트)를 받습니다. StringBytes가 NULL이면 이 정보가 반환되지 않습니다.

반환 값

반환 코드	설명
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 버퍼 가 문자열을 저장할 만큼 크지 않았고 버퍼에 맞게 문자열이 잘렸습니다. 버퍼에 하나 이상의 문자에 대한 공간이 있는 경우 잘린 문자열은 null로 종료됩니다.
E_INVALIDARG	대상에서 MaxBytes 를 읽은 후 null 종결자를 찾을 수 없습니다.