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

Метод IDiscRecorder::OpenExclusive (imapi.h)

  • Статья

Открывает средство записи дисков для монопольного доступа.

Синтаксис

HRESULT OpenExclusive();

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

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

Комментарии

Этот метод блокирует доступ файловой системы к регистратору через такие приложения, как Обозреватель. Средство записи должно быть открыто с помощью этого метода, прежде чем можно будет использовать следующие методы: QueryMediaType, Eject, Erase и Close.

Важно закрыть средство записи перед вызовом IDiscMaster::RecordDisc, иначе оно завершится сбоем при IMAPI_E_DEVICE_NOTACCESSIBLE. Устройство фиксируется исключительно для доступа через IDiscRecorder или IDiscMaster, но не одновременно. Это необходимо для того, чтобы не было путаницы в отношении разрешенных операций и владения регистратором во время управления приложениями или ожога.

Монопольная блокировка должна быть удержана в течение как можно более короткого времени. Запросы, поступающие от других компонентов операционной системы, не помещаются в очередь для последующего выполнения. Вместо этого они просто не удается. Это может привести к путанице с пользователями, которые не думают, что происходит ожог.

При вызове OpenExclusive в файловой системе отображается, что диск был удален. При выполнении соответствующего вызова Close в файловой системе отображается, что носитель снова появился. Это может привести к проблемам с автоматическим запуском.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imapi.h
Библиотека Uuid.lib
DLL Actxprxy.dll

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

IDiscRecorder