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

  • Статья

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

Функция SetNtmsMediaComplete помечает часть логического носителя как завершенную.

Синтаксис

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

Параметры

[in] hSession

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

[in] lpMediaId

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

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

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

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

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

Комментарии

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

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

Требования

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

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

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

MountNtmsMedia