IPortableDeviceResources::CreateResource 方法 (portabledeviceapi.h)
CreateResource 方法创建资源。
语法
HRESULT CreateResource(
[in] IPortableDeviceValues *pResourceAttributes,
[out] IStream **ppData,
[out] DWORD *pdwOptimalWriteBufferSize,
[out] LPWSTR *ppszCookie
);
parameters
[in] pResourceAttributes
指向以下对象参数属性的指针。
Attribute | 说明 |
---|---|
WPD_OBJECT_NAME | 对象名称。 |
WPD_RESOURCE_ATTRIBUTE_TOTAL_SIZE | 资源数据流的总大小。 |
WPD_RESOURCE_ATTRIBUTE_FORMAT | 资源数据流的格式。 |
WPD_RESOURCE_ATTRIBUTE_RESOURCE_KEY | 资源键。 |
[out] ppData
指向调用方可以写入资源数据的流的指针。
[out] pdwOptimalWriteBufferSize
指向值的指针,该值指定写入流时的最佳缓冲区大小。 此参数是可选的。
[out] ppszCookie
指向标识资源创建请求的 Cookie 的指针。 此参数可选。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
至少有一个参数是 NULL 指针。 |
注解
当应用程序调用此方法时,它必须指定资源属性,并且必须将所需的数据写入此方法返回的流。
方法返回时,不会创建资源;当应用程序通过在 ppData 指向的流上调用 Commit 方法提交数据时创建它。
若要取消到资源的数据传输,应用程序必须在 ppData 指向的流上调用 Revert 方法。 取消传输后,应用程序必须调用 IUnknown::Release 以关闭流。
要求
目标平台 | Windows |
标头 | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |