Метод IWMDMStorageControl::Rename (mswmdm.h)

Статья
02/29/2024

Метод Rename переименовывает текущее хранилище.

Синтаксис

HRESULT Rename(
  [in] UINT          fuMode,
  [in] LPWSTR        pwszNewName,
  [in] IWMDMProgress *pProgress
);

Параметры

[in] fuMode

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

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

[in] pwszNewName

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

[in] pProgress

Необязательный указатель на интерфейс IWMDMProgress , реализованный приложением для отслеживания хода выполнения действия.

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

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

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

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

Если указан флаг WMDM_MODE_THREAD, необходимо получить состояние завершения, вызвав IWMDMProgress2::End2 или IWMDMProgress3::End3. Эти методы гарантируют завершение операции, а также возвращают HRESULT со сведениями об успешном или неудачном выполнении.

Если приложение использует WMDM_MODE_THREAD и передает параметр pProgress, отличный от NULL, приложение должно убедиться, что объект, которому принадлежит pProgress, не будет уничтожен до завершения операции чтения, так как диспетчер устройств Windows Media будет отправлять уведомления о ходе выполнения в этот объект. Этот объект можно уничтожить только после получения уведомления о завершении. Невыполнение этого действия приведет к нарушениям доступа.