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

  • Статья

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

Функция DismountNtmsMedia помещает в очередь команду для перемещения указанного носителя на диске в хранилище. Эта функция должна быть связана с функцией MountNtmsMedia .

Синтаксис

DWORD DismountNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       dwCount,
  [in] DWORD       dwOptions
);

Параметры

[in] hSession

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

[in] lpMediaId

Массив по крайней мере с одной логической средой или стороной.

[in] dwCount

Число идентификаторов мультимедиа в параметре lpMediaId .

[in] dwOptions

Параметры. Этот параметр может иметь следующее значение.

Значение Значение
NTMS_DISMOUNT_DEFERRED
 Помечает состояние мультимедиа как "Отключаемое" и сохраняет среду на диске. Последующие запросы на подключение выполняются с помощью отключенных или отключенных дисков. По умолчанию отключается немедленно.
NTMS_DISMOUNT_IMMEDIATE
 Немедленно отключите диск.

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

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

Значение Значение
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS в пул носителей или библиотеку, содержащую носитель, отклоняется. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.
ERROR_DATABASE_FAILURE
 База данных недоступна или повреждена.
ERROR_DATABASE_FULL
 База данных заполнена.
ERROR_DEVICE_NOT_AVAILABLE
 Один или несколько ресурсов, необходимых для выполнения отключения, в настоящее время недоступны (вероятно, отключены).
ERROR_INVALID_LIBRARY
 Недопустимая библиотека, содержащая носитель.
ERROR_INVALID_MEDIA
 По крайней мере один из указанных носителей недопустим.
ERROR_INVALID_STATE
 Во время отключения произошло непредвиденное состояние носителя или устройства.
ERROR_MEDIA_OFFLINE
 Указанный носитель находится в автономном режиме.
ERROR_MEDIA_NOT_AVAILABLE
 Один или несколько ресурсов мультимедиа, необходимых для подключения, в настоящее время недоступны (вероятно, отключены).
ERROR_NOT_ENOUGH_MEMORY
 Во время обработки произошел сбой выделения памяти.
ERROR_SUCCESS
 Отключение носителя поставлено в очередь.
ERROR_TIMEOUT
 Истекло время ожидания, когда приложение пытался получить один или несколько ресурсов.

Комментарии

Приложение должно использовать функцию DismountNtmsMedia , чтобы освободить ресурс диска после того, как приложение использовало указанный носитель. Неизданные носители не могут использоваться другими сеансами RSM.

Функция DismountNtmsMedia возвращается, как только операция помещается в очередь с RSM. Приложение может ждать, пока боковое состояние не станет бездействующее.

Требования

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

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

Функции служб мультимедиа

MountNtmsMedia