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

Статья
08/25/2023

Метод Delete окончательно удаляет это хранилище.

Синтаксис

HRESULT Delete(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

Параметры

[in] fuMode

Один или два из следующих флагов в сочетании с побитовой ИЛИ. Укажите ровно один из первых двух режимов; третий режим является необязательным.

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

[in] pProgress

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

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

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

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

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

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

После завершения операции Удаления все ссылки на удаленный объект становятся недействительными. Приложение должно освободить эти интерфейсы и любые другие интерфейсы или ресурсы, связанные с объектом .

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