Функция EjectNtmsMedia (ntmsapi.h)

Статья
08/25/2023

[Диспетчер съемных носителей больше недоступен в Windows 7 и Windows Server 2008 R2.]

Функция EjectNtmsMedia извлекает указанный носитель из порта текущей библиотеки. Если библиотека занята, RSM помещает в очередь EjectNtmsMedia и возвращает успешное выполнение.

Синтаксис

DWORD EjectNtmsMedia(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpMediaId,
  [in, out] LPNTMS_GUID lpEjectOperation,
  [in]      DWORD       dwAction
);

Параметры

[in] hSession

Дескриптор сеанса, возвращаемого функцией OpenNtmsSession .

[in] lpMediaId

Уникальный идентификатор физического носителя (PMID).

[in, out] lpEjectOperation

GUID запроса библиотеки процесса извлечения. Если параметр dwAction имеет NTMS_EJECT_START, этот параметр получает GUID для операции. Если параметр dwAction NTMS_EJECT_STOP, для этого параметра необходимо задать guid, чтобы операция была остановлена. Этот параметр не используется с NTMS_EJECT_QUEUE.

[in] dwAction

Выполняемая операция. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
NTMS_EJECT_START	Запустите операцию извлечения с помощью порта. Указанный носитель извлекается до тех пор, пока не произойдет событие времени ожидания или функция снова не вызывается с NTMS_EJECT_STOP. Значение времени ожидания указывается в объекте библиотеки и применяется ко всем выбросам в библиотеке.
NTMS_EJECT_STOP	Завершите процесс извлечения, заданный lpEjectOperation , до истечения времени ожидания события.
NTMS_EJECT_QUEUE	Поставить указанный носитель в очередь для извлечения. Используется для группировки мультимедиа для многослотовых NTMS_IEPORT объектов.

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

Эта функция возвращает одно из следующих значений.

Значение	Значение
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS в библиотеку запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.
ERROR_BUSY	В очереди было больше носителей, чем слотов, доступных в объекте NTMS_IEPORT.
ERROR_DATABASE_FAILURE	База данных недоступна или повреждена.
ERROR_DATABASE_FULL	База данных заполнена.
ERROR_DEVICE_NOT_AVAILABLE	Библиотека отключена.
ERROR_INVALID_HANDLE	Идентификатор сеанса отсутствует или недопустим.
ERROR_INVALID_OPERATION	Для недопустимого идентификатора операции была выполнена остановка.
ERROR_INVALID_PARAMETER	Отсутствует указатель идентификатора библиотеки или идентификатора операции.
ERROR_LIBRARY_OFFLINE	Идентификатор библиотеки относится к автономной библиотеке, которая не может извлечь носитель.
ERROR_MEDIA_NOT_AVAILABLE	Носитель отключен.
ERROR_NOT_ENOUGH_MEMORY	Во время обработки произошел сбой выделения.
ERROR_SUCCESS	Извлечение помещается в очередь.

Носитель, выброшенный с помощью функции EjectNtmsMedia , перемещается в автономную библиотеку или удаляется из базы данных. При извлечении удаляются более чистые кассеты, носители импорта, нераспознанные носители и несовместимые носители.

Флаг NTMS_EJECT_QUEUE используется для пакетного или пакетного носителя, помеченного для извлечения в библиотеку с несколькими слотами. Вы можете ставить носитель в очередь для извлечения с помощью действия очереди, когда приложение поставило в очередь все необходимые носители. Приложение использует команду start, чтобы начать операцию физического извлечения. Если в очереди больше носителей, чем слотов в объекте NTMS_IEPORT, EjectNtmsMedia возвращает ERROR_BUSY. Чтобы начать операцию физического извлечения, приложение может использовать NTMS_EJECT_START с последним идентификатором носителя или NULL.

Если носитель в данный момент используется (подключен или открыт), эта функция возвращает ошибку.

Если у библиотеки нет порта, используйте функцию AccessNtmsLibraryDoor для вставки и извлечения носителя.

Функция EjectNtmsMedia не работает с автономной библиотекой.

Требования

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

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

InjectNtmsMedia

Функции управления библиотекой