共用方式為


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

Delete 方法會從裝置上的指定物件中刪除指定的屬性。

語法

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

參數

[in] pszObjectID

Null 終止字串的指標,指定您要刪除其屬性的物件識別碼。 若要指定裝置,請使用 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
程式庫 PortableDeviceGUIDs.lib

另請參閱

IPortableDeviceProperties 介面