IPortableDeviceProperties::D elete 方法 (portabledeviceapi.h)

Delete 方法从设备上的指定对象中删除指定属性。

语法

HRESULT Delete(
  [in] LPCWSTR                      pszObjectID,
  [in] IPortableDeviceKeyCollection *pKeys
);

参数

[in] pszObjectID

指向以 null 结尾的字符串的指针,该字符串指定要删除其属性的对象 ID。 若要指定设备,请使用 WPD_DEVICE_OBJECT_ID

[in] pKeys

指向 IPortableDeviceKeyCollection 接口的指针,该接口指定要删除的属性。 有关 Windows 可移植设备定义的属性列表,请参阅 属性和属性

返回值

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

返回代码 说明
S_OK
方法成功。
S_FALSE
无法删除一个或多个属性值。
E_POINTER
所需的指针参数为 NULL

注解

仅当属性WPD_PROPERTY_ATTRIBUTE_CAN_DELETE属性为 True 时,才能删除属性。 可以通过调用 GetPropertyAttributes 来检索此属性。

驱动程序无法指示部分成功;也就是说,如果只能删除某些属性,驱动程序将返回 S_FALSE,但此方法不指示已成功删除哪些属性。 了解已删除哪些属性的唯一方法是通过调用 IPortableDeviceProperties::GetValues 请求所有属性。

要求

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

另请参阅

IPortableDeviceProperties 接口