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

CreateResource 메서드는 리소스를 만듭니다.

구문

HRESULT CreateResource(
  [in]  IPortableDeviceValues *pResourceAttributes,
  [out] IStream               **ppData,
  [out] DWORD                 *pdwOptimalWriteBufferSize,
  [out] LPWSTR                *ppszCookie
);

매개 변수

[in] pResourceAttributes

다음 개체 매개 변수 특성에 대한 포인터입니다.

특성	설명
WPD_OBJECT_NAME	개체 이름입니다.
WPD_RESOURCE_ATTRIBUTE_TOTAL_SIZE	리소스 데이터 스트림의 총 크기입니다.
WPD_RESOURCE_ATTRIBUTE_FORMAT	리소스 데이터 스트림의 형식입니다.
WPD_RESOURCE_ATTRIBUTE_RESOURCE_KEY	리소스 키입니다.

[out] ppData

호출자가 리소스 데이터를 쓸 수 있는 스트림에 대한 포인터입니다.

[out] pdwOptimalWriteBufferSize

스트림에 쓸 때 최적의 버퍼 크기를 지정하는 값에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다.

[out] ppszCookie

리소스 만들기 요청을 식별하는 쿠키에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

반환 값

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

반환 코드	설명
S_OK	메서드가 성공했습니다.
E_POINTER	인수 중 하나 이상이 NULL 포인터였습니다.

설명

애플리케이션이 이 메서드를 호출할 때 리소스 특성을 지정해야 하며 이 메서드가 반환하는 스트림에 필요한 데이터를 작성해야 합니다.

메서드가 반환되면 리소스가 만들어지지 않습니다. 애플리케이션이 ppData가 가리키는 스트림에서 Commit 메서드를 호출하여 데이터를 커밋할 때 만들어집니다.

리소스에 대한 데이터 전송을 취소하려면 애플리케이션이 ppData가 가리키는 스트림에서 Revert 메서드를 호출해야 합니다. 전송이 취소되면 애플리케이션은 IUnknown::Release 를 호출하여 스트림을 닫아야 합니다.

요구 사항

대상 플랫폼	Windows
헤더	portabledeviceapi.h
라이브러리	PortableDeviceGUIDs.lib

추가 정보

IPortableDeviceResources 인터페이스