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

  • Статья

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

Функция DeleteNtmsMediaType удаляет указанное отношение типа носителя из указанной библиотеки при условии, что библиотека не содержит физических объектов мультимедиа указанного типа мультимедиа.

Синтаксис

DWORD DeleteNtmsMediaType(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaTypeId,
  [in] LPNTMS_GUID lpLibId
);

Параметры

[in] hSession

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

[in] lpMediaTypeId

Уникальный идентификатор типа мультимедиа, удаляемого из библиотеки.

[in] lpLibId

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

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

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

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

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

Комментарии

Если в системе RSM отсутствуют физические объекты мультимедиа указанного типа мультимедиа и нет объектов библиотеки, содержащих указанное отношение типа носителя в системе RSM, пулы носителей системы для этого типа мультимедиа будут удалены. Невозможность удалить системные пулы носителей не приводит к сбою функции DeleteNtmsMediaType .

Требования

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

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

AddNtmsMediaType

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