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

  • Artículo

El método Delete elimina uno o varios objetos del dispositivo.

Sintaxis

HRESULT Delete(
  [in]      const DWORD                          dwOptions,
  [in]      IPortableDevicePropVariantCollection *pObjectIDs,
  [in, out] IPortableDevicePropVariantCollection **ppResults
);

Parámetros

[in] dwOptions

Uno de los enumeradores de DELETE_OBJECT_OPTIONS .

[in] pObjectIDs

Puntero a una interfaz IPortableDevicePropVariantCollection que contiene una o varias cadenas terminadas en null (tipo VT_LPWSTR) que especifican los identificadores de objeto de los objetos que se van a eliminar.

[in, out] ppResults

Opcional. Al devolver, este parámetro contiene una colección de valores de VT_ERROR que indican el éxito o error de la operación. El primer elemento devuelto en ppResults corresponde al primer objeto de la colección pObjectIDs , el segundo elemento devuelto en ppResults corresponde al segundo objeto de la colección pObjectIDs , etc. Este parámetro puede ser NULL si la aplicación no está relacionada con los resultados.

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. Si se devuelve algún valor de error, no se eliminaron objetos en el dispositivo.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
S_FALSE
 No se pudo eliminar al menos un objeto. El parámetro ppResults , si se especifica, contiene el código de error por objeto.
E_XXXXXXXX
 El controlador no eliminó ningún objeto.
E_INVALIDARG
 Se especificó un valor no válido para dwOptions.
E_ACCESSDENIED
 La aplicación no tiene permiso para eliminar el objeto.
HRESULT_FROM_WIN32(ERROR_DIR_NOT_EMPTY)
 No se pudo eliminar la carpeta o directorio especificado porque no estaba vacía.
HRESULT_FROM_WIN32(ERROR_INVALID_OPERATION)
 La aplicación especificó PORTABLE_DEVICE_DELETE_NO_RECURSION y el objeto tiene elementos secundarios.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 No se pudo eliminar el objeto porque no existe en el dispositivo.

Comentarios

Para ver si se admite la eliminación recursiva, llame a IPortableDeviceCapabilities::GetCommandOptions. Si la interfaz IPortableDeviceValues recuperada contiene un valor de propiedad denominado WPD_OPTION_OBJECT_MANAGEMENT_RECURSIVE_DELETE_SUPPORTED con un valor boolVal de True, el dispositivo admite la eliminación recursiva.

En la tabla siguiente se enumeran los posibles códigos de retorno que pueden aparecer en la colección en la que puntos ppResults .

Ejemplos

Para obtener un ejemplo de cómo usar este método, vea Eliminar contenido del dispositivo.

Requisitos

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

Consulte también

Eliminar contenido del dispositivo

IPortableDeviceContent (Interfaz)