IStream_Read 함수(shlwapi.h)

지정된 스트림에서 바이트를 읽고 모든 바이트를 성공적으로 읽었는지 여부를 나타내는 값을 반환합니다.

구문

LWSTDAPI IStream_Read(
  [in]  IStream *pstm,
  [out] void    *pv,
  [in]  ULONG   cb
);

[in] pstm

형식: IStream*

읽을 스트림의 IStream 인터페이스에 대한 포인터입니다.

[out] pv

형식: VOID*

pstm에서 스트림 데이터를 수신하는 버퍼에 대한 포인터입니다. 이 버퍼의 크기는 cb 바이트 이상이어야 합니다.

[in] cb

형식: ULONG

함수가 입력 스트림에서 읽으려고 시도하는 데이터 바이트 수입니다.

형식: HRESULT

함수가 스트림에서 지정된 바이트 수를 성공적으로 읽거나 COM 오류 코드를 읽 는 경우 S_OK 반환합니다. 특히 읽기 시도가 성공했지만 cb 바이트보다 적은 경우 함수는 E_FAIL 반환합니다.

이 함수는 ISequentialStream::Read 메서드를 호출하여 지정된 스트림에서 버퍼로 데이터를 읽습니다. 어떤 이유로든 함수가 실패하면 출력 버퍼의 내용과 입력 스트림의 읽기 포인터 위치가 정의되지 않습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server, Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlwapi.h
DLL	Shlwapi.dll(버전 5.0 이상)