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를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | 설명 |
|---|---|
|
메서드가 성공했습니다. |
|
인수 중 하나 이상이 NULL 포인터였습니다. |
설명
애플리케이션이 이 메서드를 호출할 때 리소스 특성을 지정해야 하며 이 메서드가 반환하는 스트림에 필요한 데이터를 작성해야 합니다.
메서드가 반환되면 리소스가 만들어지지 않습니다. 애플리케이션이 ppData가 가리키는 스트림에서 Commit 메서드를 호출하여 데이터를 커밋할 때 만들어집니다.
리소스에 대한 데이터 전송을 취소하려면 애플리케이션이 ppData가 가리키는 스트림에서 Revert 메서드를 호출해야 합니다. 전송이 취소되면 애플리케이션은 IUnknown::Release 를 호출하여 스트림을 닫아야 합니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | portabledeviceapi.h |
| 라이브러리 | PortableDeviceGUIDs.lib |