ILockBytes::ReadAt 메서드(objidl.h)

ReadAt 메서드는 바이트 배열 개체의 시작 부분에서 지정된 오프셋에서 시작하는 지정된 바이트 수를 읽습니다.

구문

HRESULT ReadAt(
  [in]  ULARGE_INTEGER ulOffset,
  [in]  void           *pv,
  [in]  ULONG          cb,
  [out] ULONG          *pcbRead
);

[in] ulOffset

데이터를 읽기 위한 바이트 배열의 시작점을 지정합니다.

[in] pv

바이트 배열을 읽을 버퍼에 대한 포인터입니다. 이 버퍼의 크기는 cb에 포함되어 있습니다.

[in] cb

바이트 배열에서 읽으려는 데이터의 바이트 수를 지정합니다.

[out] pcbRead

이 메서드가 바이트 배열에서 읽은 실제 바이트 수를 쓰는 ULONG 에 대한 포인터입니다. 이 값에 관심이 없음을 나타내려면 이 포인터를 NULL 로 설정할 수 있습니다. 이 경우 이 메서드는 읽은 실제 바이트 수를 제공하지 않습니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
S_OK	지정된 바이트 수를 읽거나 바이트 배열의 끝까지 읽은 최대 바이트 수를 나타냅니다.
E_FAIL	바이트 배열에서 데이터를 읽을 수 없습니다.
E_PENDING	비동기 스토리지만 해당: 읽을 데이터의 일부 또는 전체를 현재 사용할 수 없습니다.
STG_E_ACCESSDENIED	호출자에게 바이트 배열에 액세스할 수 있는 권한이 없습니다.
STG_E_READFAULT	읽을 바이트 수가 실제로 읽은 바이트 수와 같지 않습니다.

ILockBytes::ReadAt는 바이트 배열 개체에서 바이트를 읽습니다. 실제로 읽은 바이트 수를 보고합니다. 이 값은 오류가 발생하거나 읽는 동안 바이트 배열의 끝에 도달하는 경우 요청된 바이트 수보다 작을 수 있습니다.

작업이 바이트 배열의 끝에 도달하면 지정된 바이트 수보다 적게 읽는 것은 오류가 아닙니다. 이는 MS-DOS FAT(파일 할당 테이블) 파일 시스템 파일에 있는 것과 동일한 파일 끝 동작입니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	objidl.h
라이브러리	Uuid.lib
DLL	Ole32.dll