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。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
E_POINTER
至少有一个参数是 NULL 指针。

注解

当应用程序调用此方法时,它必须指定资源属性,并且必须将所需的数据写入此方法返回的流。

方法返回时,不会创建资源;当应用程序通过在 ppData 指向的流上调用 Commit 方法提交数据时创建它。

若要取消到资源的数据传输,应用程序必须在 ppData 指向的流上调用 Revert 方法。 取消传输后,应用程序必须调用 IUnknown::Release 以关闭流。

要求

   
目标平台 Windows
标头 portabledeviceapi.h
Library PortableDeviceGUIDs.lib

请参阅

IPortableDeviceResources 接口