共用方式為


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

識別資源建立要求的 Cookie 指標。 這是選擇性參數。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
此方法已成功。
E_POINTER
至少有一個引數是 Null 指標。

備註

當應用程式呼叫這個方法時,它必須指定資源屬性,而且必須將必要的資料寫入這個方法傳回的資料流程。

方法傳回時不會建立資源;當應用程式在ppData指向的資料流程上呼叫Commit方法,即可建立它。

若要取消對資源的資料傳輸,應用程式必須在ppData點所在的資料流程上呼叫Revert方法。 取消傳輸之後,應用程式必須叫用 IUnknown::Release 才能關閉資料流程。

需求

   
目標平台 Windows
標頭 portabledeviceapi.h
程式庫 PortableDeviceGUIDs.lib

另請參閱

IPortableDeviceResources 介面