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 이상) |