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

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

  • Статья

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

Функция MoveToNtmsMediaPool перемещает указанный носитель из текущего пула мультимедиа в указанный пул носителей.

Синтаксис

DWORD MoveToNtmsMediaPool(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] LPNTMS_GUID lpPoolId
);

Параметры

[in] hSession

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

[in] lpMediaId

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

[in] lpPoolId

Уникальный идентификатор пула носителей назначения.

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

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

Значение Значение
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS в пул носителей запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.

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

Комментарии

Целевой пул, указанный в функции MoveToNtmsMediaPool , должен иметь тот же тип мультимедиа и совместимую безопасность.

RSM записывает идентификатор носителя на носитель перед перемещением носителя в пул свободных носителей.

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

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

Требования

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

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

AllocateNtmsMedia

CreateNtmsMediaPool

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