Поделиться через

Метод 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
Header portabledeviceapi.h
Библиотека PortableDeviceGUIDs.lib

См. также раздел

Интерфейс IPortableDeviceProperties