Método IPortableDeviceContent::Move (portabledeviceapi.h)

El método Move mueve uno o varios objetos de una ubicación del dispositivo a otra.

Sintaxis

HRESULT Move(
  [in]      IPortableDevicePropVariantCollection *pObjectIDs,
  [in]      LPCWSTR                              pszDestinationFolderObjectID,
  [in, out] IPortableDevicePropVariantCollection **ppResults
);

Parámetros

[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 mover.

[in] pszDestinationFolderObjectID

Puntero a una cadena terminada en null que especifica el identificador del destino.

[in, out] ppResults

Opcional. A la devolución, este parámetro contiene una colección de valores de VT_ERROR que indican el éxito o el 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	Se eliminaron uno o varios objetos, pero no se pudo eliminar al menos un objeto. Consulte ppFailedObjectIDs para saber qué objetos no se eliminaron.
E_ACCESSDENIED	La aplicación no tiene derechos para mover el objeto.
E_POINTER	Al menos uno de los argumentos necesarios era un puntero NULL .

Comentarios

Si el dispositivo especificado admite operaciones de movimiento en un almacenamiento funcional, el parámetro pszDestinationFolderObjectID puede especificar el identificador de un almacenamiento funcional.

Ejemplos

Para obtener un ejemplo de cómo usar este método, vea Mover contenido en el dispositivo.

Requisitos

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

Consulte también

IPortableDeviceContent (Interfaz)

Mover contenido en el dispositivo