Método IPortableDeviceProperties::D elete (portabledeviceapi.h)

  • Artículo

El método Delete elimina las propiedades especificadas de un objeto especificado en un dispositivo.

Sintaxis

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

Parámetros

[in] pszObjectID

Puntero a una cadena terminada en null que especifica el identificador del objeto cuyas propiedades eliminará. Para especificar el dispositivo, use WPD_DEVICE_OBJECT_ID.

[in] pKeys

Puntero a una interfaz IPortableDeviceKeyCollection que especifica las propiedades que se van a eliminar. Para obtener una lista de las propiedades definidas por dispositivos portátiles de Windows, vea Propiedades y atributos.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
S_FALSE
 No se pudieron eliminar uno o más valores de propiedad.
E_POINTER
 El argumento de puntero requerido era NULL.

Comentarios

Las propiedades solo se pueden eliminar si su atributo WPD_PROPERTY_ATTRIBUTE_CAN_DELETE es True. Este atributo se puede recuperar llamando a GetPropertyAttributes.

El controlador no tiene ninguna manera de indicar el éxito parcial; es decir, si solo se podrían eliminar algunas propiedades, el controlador devolverá S_FALSE, pero este método no indica qué propiedades se eliminaron correctamente. La única manera de aprender qué propiedades se eliminaron es solicitar todas las propiedades llamando a IPortableDeviceProperties::GetValues.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado portabledeviceapi.h
Library PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceProperties (interfaz)