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。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
至少有一個引數是 Null 指標。 |
備註
當應用程式呼叫這個方法時,它必須指定資源屬性,而且必須將必要的資料寫入這個方法傳回的資料流程。
方法傳回時不會建立資源;當應用程式在ppData指向的資料流程上呼叫Commit方法,即可建立它。
若要取消對資源的資料傳輸,應用程式必須在ppData點所在的資料流程上呼叫Revert方法。 取消傳輸之後,應用程式必須叫用 IUnknown::Release 才能關閉資料流程。
需求
目標平台 | Windows |
標頭 | portabledeviceapi.h |
程式庫 | PortableDeviceGUIDs.lib |