IPortableDeviceResources::GetStream 메서드(portabledeviceapi.h)

GetStream 메서드는 디바이스의 개체에서 콘텐츠 데이터를 읽거나 쓸 수 있는 IStream 인터페이스를 가져옵니다. 검색된 인터페이스를 사용하면 개체 데이터를 읽거나 쓸 수 있습니다.

구문

HRESULT GetStream(
  [in]      LPCWSTR        pszObjectID,
  [in]      REFPROPERTYKEY Key,
  [in]      const DWORD    dwMode,
  [in, out] DWORD          *pdwOptimalBufferSize,
  [out]     IStream        **ppStream
);

매개 변수

[in] pszObjectID

개체의 개체 ID를 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] Key

읽을 리소스를 지정하는 REFPROPERTYKEY 입니다. GetSupportedResources를 호출하여 모든 개체 리소스의 키를 검색할 수 있습니다.

[in] dwMode

다음 액세스 모드 중 하나입니다.

• STGM_READ(읽기 전용 액세스)
• STGM_WRITE(쓰기 전용 액세스)
• STGM_READWRITE(읽기/쓰기 액세스)

[in, out] pdwOptimalBufferSize

ppStream을 사용하여 데이터를 읽거나 쓸 때 사용할 가장 적합한 버퍼 크기의 추정치를 지정하는 DWORD에 대한 선택적 포인터입니다. 이 값을 지원하려면 드라이버가 필요합니다.

[out] ppStream

IStream 인터페이스 포인터에 대한 포인터입니다. 이 인터페이스는 개체에 데이터를 읽고 쓰는 데 사용됩니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	필요한 포인터 인수 중 하나 이상이 NULL이었습니다.

설명

검색된 스트림은 폴더의 내용을 재귀적으로 읽을 수 없습니다. 개체의 모든 리소스를 복사하려면 Key에 WPD_RESOURCE_DEFAULT 지정합니다.

개체가 리소스를 지원하지 않는 경우 이 메서드는 오류를 반환하고 ppStream 은 NULL이 됩니다.

애플리케이션은 읽기 또는 쓰기 작업을 위해 버퍼를 할당할 때 pdwOptimalBufferSize 에서 반환되는 버퍼 크기를 사용해야 합니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	portabledeviceapi.h
라이브러리	PortableDeviceGUIDs.lib

추가 정보

IPortableDeviceResources 인터페이스