Метод IPortableDeviceContent::Move (portabledeviceapi.h)

Статья
03/15/2023

Метод Move перемещает один или несколько объектов из одного расположения на устройстве в другое.

Синтаксис

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

Параметры

[in] pObjectIDs

Указатель на интерфейс IPortableDevicePropVariantCollection , содержащий одну или несколько строк с завершением NULL (тип VT_LPWSTR), указывающих идентификаторы объектов, которые необходимо переместить.

[in] pszDestinationFolderObjectID

Указатель на строку, завершающуюся значением NULL, которая указывает идентификатор назначения.

[in, out] ppResults

Необязательный элемент. При возврате этот параметр содержит коллекцию VT_ERROR значений, указывающих на успешное или неудачное выполнение операции. Первый элемент, возвращенный в ppResults , соответствует первому объекту в коллекции pObjectIDs , второй элемент, возвращенный в ppResults , соответствует второму объекту в коллекции pObjectIDs и т. д. Этот параметр может иметь значение NULL , если приложение не связано с результатами.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице. Если возвращается какое-либо значение ошибки, объекты на устройстве не были удалены.

Код возврата	Описание
S_OK	Метод выполнен успешно.
S_FALSE	Один или несколько объектов были удалены, но по крайней мере один объект не может быть удален. Сведения о том, какие объекты не были удалены, см. в разделе ppFailedObjectIDs .
E_ACCESSDENIED	Приложение не имеет прав на перемещение объекта .
E_POINTER	По крайней мере один из обязательных аргументов был пустым указателем.

Если указанное устройство поддерживает операции перемещения в функциональном хранилище, параметр pszDestinationFolderObjectID может указать идентификатор функционального хранилища.

Примеры

Пример использования этого метода см. в разделе Перемещение содержимого на устройстве.

Требования

Требование	Значение
Целевая платформа	Windows
Header	portabledeviceapi.h
Библиотека	PortableDeviceGUIDs.lib

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

Интерфейс IPortableDeviceContent

Перемещение содержимого на устройстве

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