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

Статья
08/25/2023

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

Функция DeallocateNtmsMedia освобождает сторону, связанную с указанным логическим носителем.

Синтаксис

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

Параметры

[in] hSession

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

[in] lpMediaId

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

dwOptions

Защищены; значение должно быть равно нулю.

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

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

Значение	Значение
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS в пул носителей запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности. Windows XP: NTMS_MODIFY_ACCESS в пул носителей запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.
ERROR_DATABASE_FAILURE	База данных недоступна или повреждена.
ERROR_DATABASE_FULL	База данных заполнена.
ERROR_INVALID_HANDLE	Дескриптор сеанса отсутствует или является недопустимым.
ERROR_INVALID_MEDIA	Недопустимый идентификатор LMID.
ERROR_INVALID_PARAMETER	Отсутствует идентификатор носителя или пула носителей.
ERROR_INVALID_PARTITION	Недопустимая сторона LMID.
ERROR_NOT_ENOUGH_MEMORY	Во время обработки произошел сбой выделения.
ERROR_SUCCESS	Функция выполнена успешно.

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

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

Windows Server 2003: Если носитель возвращается в свободный пул, требуется NTMS_USE_ACCESS в свободный пул и NTMS_CONTROL_ACCESS в исходный пул. Если бесплатный пул не является целевым пулом носителей, NTMS_CONTROL_ACCESS требуется как в исходном, так и в целевом пулах.

Требования

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

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

AllocateNtmsMedia

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