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。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
無法刪除一或多個屬性值。 |
|
必要的指標自變數為 NULL。 |
備註
只有在屬性WPD_PROPERTY_ATTRIBUTE_CAN_DELETE為 True 時,才能刪除屬性。 呼叫 GetPropertyAttributes 即可擷取這個屬性。
驅動程式無法指出部分成功;也就是說,如果只能刪除某些屬性,驅動程式會傳回 S_FALSE,但此方法不會指出已成功刪除哪些屬性。 瞭解已刪除哪些屬性的唯一方法是呼叫 IPortableDeviceProperties::GetValues 來要求所有屬性。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | portabledeviceapi.h |
程式庫 | PortableDeviceGUIDs.lib |