Метод IMDSPObject::Move (mswmdm.h)

Статья
08/25/2023

Метод Move перемещает файл или папку на устройстве мультимедиа.

Синтаксис

HRESULT Move(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress,
  [in] IMDSPStorage  *pTarget
);

Параметры

[in] fuMode

Режим обработки, с помощью которого вызывается операция Перемещения и метод, с помощью которого выполняется перемещение. Укажите один из следующих двух режимов. Если указаны оба режима, используется блочный режим.

Режим	Описание
WMDM_MODE_BLOCK	Операция будет выполняться с использованием обработки в блочном режиме. Вызов не будет возвращать, пока операция не будет завершена.
WMDM_MODE_THREAD	Операция будет выполняться с использованием обработки в потоковом режиме. Вызов будет немедленно возвращен, и операция будет выполнена в фоновом потоке.

В следующей таблице перечислены флаги, указывающие, куда будет перемещен объект. Одно значение из этой таблицы объединяется с одним значением из предыдущей таблицы Mode с использованием побитового ИЛИ.

Метод перемещения	Описание
WMDM_STORAGECONTROL_INSERTBEFORE	Объект будет вставлен перед целевым объектом.
WMDM_STORAGECONTROL_INSERTINTO	Объект будет вставлен в целевой объект . Целевой объект должен быть папкой. Если целевой объект является файлом, этот метод завершается ошибкой.
WMDM_STORAGECONTROL_INSERTAFTER	Объект будет вставлен после целевого объекта.

[in] pProgress

Указатель на интерфейс IWMDMProgress , реализованный приложением для отслеживания хода выполнения текущих операций. Этот параметр является необязательным и должен иметь значение NULL , если он не используется.

[in] pTarget

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

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

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

Стандартные коды ошибок COM
Коды ошибок Windows, преобразованные в значения HRESULT
Коды ошибок диспетчер устройств Windows Media

Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Файл или каталог можно перемещать только в том же корневом хранилище. Объект, для которого вызывается этот метод, должен быть обновлен в соответствии с его новым расположением.

Этот метод является необязательным. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.