Share via


IPortableDeviceResources::GetResourceAttributes 方法 (portabledeviceapi.h)

GetResourceAttributes 方法會從 物件中指定的資源擷取所有屬性。

語法

HRESULT GetResourceAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppResourceAttributes
);

參數

[in] pszObjectID

Null 終止字串的指標,其中包含裝載資源之對象的物件標識碼。

[in] Key

REFPROPERTYKEY,指定要查詢的資源。

[out] ppResourceAttributes

IPortableDeviceValues 介面指標的指標,該指標會分別保存描述每個屬性及其值的 PROPERTYKEY/PROPVARIANT 配對。 屬性值的實值類型會有所不同。 如果無法傳回屬性,傳回之屬性的值將會 VT_ERROR,而 PROPVARIANTscode 成員將包含該特定失敗的 HRESULT

傳回值

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

傳回碼 描述
S_OK
已擷取所有屬性值。
S_FALSE
無法擷取一或多個屬性值。 這些值在擷取的 ppResourceAttributes 參數中會有類型為 VT_ERROR的 HRESULT 值。
E_POINTER
至少其中一個必要的指標自變數為 NULL

備註

資源屬性描述與資源相關的訪問許可權、大小、格式和其他資訊。 例如,影像物件上音訊註釋資源的屬性可以指定音訊的比特率、通道計數和數據格式。

規格需求

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

另請參閱

IPortableDeviceResources 介面