共用方式為

IPortableDeviceProperties：：GetPropertyAttributes 方法 (portabledeviceapi.h)

  • 發行項

GetPropertyAttributes 方法會擷取裝置上指定之物件屬性的屬性。

語法

HRESULT GetPropertyAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

參數

[in] pszObjectID

Null 終止字串的指標，其中包含要查詢之對象的物件標識碼。 若要指定裝置，請使用 WPD_DEVICE_OBJECT_ID。

[in] Key

REFPROPERTYKEY，指定要查詢的屬性。 您可以呼叫 GetSupportedProperties 來擷取支援的屬性清單。 如需 Windows 可攜式裝置所定義的屬性清單，請參閱 屬性和屬性。

[out] ppAttributes

接收 IPortableDeviceValues 介面指標的變數位址，該介面包含擷取的屬性屬性。 這些是 PROPERTYKEY/值組，其中 PROPERTYKEY 是 屬性，而 value 數據類型則取決於特定屬性。 呼叫端必須在使用此介面完成時釋放這個介面。 您可以在 [ 屬性] 和 [屬性 ] 頁面上找到 Windows 可攜式裝置定義的屬性。

傳回值

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

傳回碼 描述
S_OK
 方法成功，而且已成功擷取所有屬性。
S_FALSE
 只能擷取某些屬性值。 其他人無法，而且會包含類型為 VT_ERROR 的 HRESULT 值。
E_POINTER
 必要的指標自變數為 NULL。

備註

屬性屬性描述屬性的訪問許可權、有效值和其他資訊。 例如，屬性可以將WPD_PROPERTY_ATTRIBUTE_CAN_DELETE值設定為 False 以防止刪除，並且將有效值的範圍儲存為個別專案。

範例

如需如何使用此方法的範例，請參閱 設定單一對象的屬性。

規格需求

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

另請參閱

IPortableDeviceProperties 介面

設定單一物件的屬性

寫入 Content-Object 屬性