Compartilhar via

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

  • Artigo

O método Move move um ou mais objetos de um local no dispositivo para outro.

Sintaxe

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

Parâmetros

[in] pObjectIDs

Ponteiro para uma interface IPortableDevicePropVariantCollection que contém uma ou mais cadeias de caracteres terminadas em nulo (tipo VT_LPWSTR) especificando as IDs de objeto dos objetos a serem movidos.

[in] pszDestinationFolderObjectID

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a ID do destino.

[in, out] ppResults

Opcional. No retorno, esse parâmetro contém uma coleção de valores VT_ERROR indicando o êxito ou a falha da operação. O primeiro elemento retornado em ppResults corresponde ao primeiro objeto na coleção pObjectIDs , o segundo elemento retornado em ppResults corresponde ao segundo objeto na coleção pObjectIDs e assim por diante. Esse parâmetro poderá ser NULL se o aplicativo não estiver preocupado com os resultados.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Se algum valor de erro for retornado, nenhum objeto foi excluído no dispositivo.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
S_FALSE
 Um ou mais objetos foram excluídos, mas pelo menos um objeto não pôde ser excluído. Consulte ppFailedObjectIDs para saber quais objetos não foram excluídos.
E_ACCESSDENIED
 O aplicativo não tem os direitos de mover o objeto.
E_POINTER
 Pelo menos um dos argumentos necessários era um ponteiro NULL .

Comentários

Se o dispositivo especificado der suporte a operações de movimentação em um armazenamento funcional, o parâmetro pszDestinationFolderObjectID poderá especificar o identificador para um armazenamento funcional.

Exemplos

Para obter um exemplo de como usar esse método, consulte Movendo conteúdo no dispositivo.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho portabledeviceapi.h
Biblioteca PortableDeviceGUIDs.lib

Confira também

IPortableDeviceContent Interface

Movendo conteúdo no dispositivo