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

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

ReadMultiByteStringVirtual 메서드는 대상에서 null로 끝나는 멀티바이트 문자열을 읽습니다.

구문

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

매개 변수

[in] Offset

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

[in] MaxBytes

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

[out, optional] Buffer

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

참고 반환된 문자열 다음에 오는 버퍼의 나머지 부분을 이 메서드에서 덮어쓸 수 있습니다.

[in] BufferSize

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

[out, optional] StringBytes

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

반환 값

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