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


Метод IDiscRecorder2::ReleaseExclusiveAccess (imapi2.h)

Освобождает монопольный доступ к устройству.

Синтаксис

HRESULT ReleaseExclusiveAccess();

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

S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Код возврата Описание
E_FAIL
Неопределенный сбой.

Значение: 0x80004005

E_OUTOFMEMORY
Не удалось выделить необходимую память.

Значение: 0x8007000E

E_IMAPI_RECORDER_COMMAND_TIMEOUT
Устройству не удалось принять команду в течение периода ожидания. Это может быть вызвано тем, что устройство перешло в несогласованное состояние, или может потребоваться увеличить время ожидания для команды.

Значение: 0xC0AA020D

HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
Указанный дескриптор недопустим.

Значение: 6

HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
Указанный сетевой ресурс или устройство больше не доступны.

Значение: 55

E_IMAPI_RECORDER_LOCKED
Устройство, связанное с этим устройством записи во время последней операции, было заблокировано исключительно, что привело к сбою этой операции.

Значение: 0xC0AA0210

Комментарии

Каждое средство записи имеет количество блокировок. Первый вызов средства записи блокирует устройство для монопольного доступа. Приложения могут использовать метод IDiscRecorder2::AcquireExclusiveAccess несколько раз для применения нескольких блокировок на устройстве. Каждый вызов увеличивает количество блокировок на единицу.

При разблокировке средства записи число блокировок должно достигать нуля, чтобы освободить устройство для других клиентов. Вызов метода ReleaseExclusiveAccess уменьшает количество блокировок на один.

Для освобождения устройства требуется равное количество вызовов методов AcquireExclusiveAccess и ReleaseExclusiveAccess . Когда число блокировок достигает нуля, записывающее устройство становится бесплатным; последняя блокировка была удалена.

Требования

   
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imapi2.h

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

IDiscRecorder2

IDiscRecorder2::AcquireExclusiveAccess

IDiscRecorder2::get_ExclusiveAccessOwner