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

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

  • Статья

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

Функция SwapNtmsMedia переключает стороны, связанные с двумя указанными идентификаторами LMID. Указанные идентификаторы LMID должны находиться в одном пуле носителей.

Синтаксис

DWORD SwapNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId1,
  [in] LPNTMS_GUID lpMediaId2
);

Параметры

[in] hSession

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

[in] lpMediaId1

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

[in] lpMediaId2

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

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

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

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

Комментарии

Функция SwapNtmsMedia используется для обновления физического носителя без влияния на приложение.

Носители для обоих идентификаторов LMID не должны использоваться для успешного выполнения этой функции.

Требования

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

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

AllocateNtmsMedia

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