다음을 통해 공유

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

  • 아티클

ReadUnicodeStringVirtualWide 메서드는 대상에서 null로 끝나는 유니코드 문자열을 읽습니다.

구문

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

매개 변수

[in] Offset

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

[in] MaxBytes

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

[out, optional] Buffer

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

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

[in] BufferSize

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

[out, optional] StringBytes

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

반환 값

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

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

메서드를 성공적으로 수행했습니다.

설명

엔진은 대상에서 MaxBytes 까지 읽고 null 종결자를 찾습니다. 문자열에 BufferSize 문자를 초과하는 경우 버 퍼에 맞게 문자열이 잘립니다.

요구 사항

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

추가 정보

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual