IPortableDeviceProperties：：GetPropertyAttributes 方法 (portabledeviceapi.h)

  • 项目

GetPropertyAttributes 方法检索设备上指定对象属性的属性。

语法

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

参数

[in] pszObjectID

指向以 null 结尾的字符串的指针，该字符串包含要查询的对象的对象 ID。 若要指定设备，请使用 WPD_DEVICE_OBJECT_ID。

[in] Key

指定要查询的属性的 REFPROPERTYKEY 。 可以通过调用 GetSupportedProperties 来检索支持的属性列表。 有关 Windows 可移植设备定义的属性列表，请参阅 属性和属性。

[out] ppAttributes

变量的地址，该变量接收指向 IPortableDeviceValues 接口的 指针，该接口保存检索到的属性特性。 这些是 PROPERTYKEY/值对，其中 PROPERTYKEY 是属性，值数据类型取决于特定属性。 调用方在使用完此接口后必须释放此接口。 可在“ 属性和属性” 页上找到由 Windows 可移植设备定义的属性。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 方法成功，并且已成功检索所有属性。
S_FALSE
 只能检索某些属性值。 其他选项不能，并且将包含类型为 VT_ERROR 的 HRESULT 值。
E_POINTER
 所需的指针参数为 NULL。

注解

属性属性描述属性的访问权限、有效值和其他信息。 例如，属性可以将WPD_PROPERTY_ATTRIBUTE_CAN_DELETE值设置为 False 以防止删除，并且将一系列有效值存储为单个条目。

示例

有关如何使用此方法的示例，请参阅 设置单个对象的属性。

要求

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

另请参阅

IPortableDeviceProperties 接口

设置单个对象的属性

写入 Content-Object 属性