CreateRandomAccessStreamOverStream 함수(shcore.h)

IStream 기본 구현 주위에 Windows 런타임 임의 액세스 스트림을 만듭니다.

구문

HRESULT CreateRandomAccessStreamOverStream(
  [in]  IStream      *stream,
  [in]  BSOS_OPTIONS options,
  [in]  REFIID       riid,
  [out] void         **ppv
);

매개 변수

[in] stream

캡슐화할 COM 스트림입니다.

[in] options

스트림을 캡슐화하는 RandomAccessStream의 동작을 지정하는 BSOS_OPTIONS 옵션 중 하나입니다.

[in] riid

일반적으로 IID_RandomAccessStream ppv를 통해 검색할 인터페이스의 IID에 대한 참조입니다.

[out] ppv

이 메서드가 성공적으로 반환되면 는 riid에서 요청된 스트림을 캡슐화하는 RandomAccessStream에 대한 인터페이스 포인터를 포함합니다.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

CreateRandomAccessStreamOverStream 함수를 사용하여 COM IStream을 캡슐화하는 RandomAccessStream을 만듭니다.

Windows 런타임 스트림과 COM 스트림 간의 상호 운용에 도움이 되는 유틸리티 클래스에 대한 자세한 내용은 RandomAccessStreamOverStream의 설명을 참조하세요.

Objbase.h에 정의된 IID_PPV_ARGS 매크로를 사용하여 riid 및 ppv 매개 변수를 패키지하는 것이 좋습니다. 이 매크로는 ppv의 값이 가리키는 인터페이스를 기반으로 올바른 IID를 제공하므로 riid 에서 코딩 오류가 발생하여 예기치 않은 결과가 발생할 수 있습니다.

요구 사항

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

추가 정보

CreateRandomAccessStreamOnFile

CreateStreamOverRandomAccessStream

RandomAccessStream