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

Статья
02/29/2024

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

Функция AddNtmsMediaType добавляет указанный тип мультимедиа в указанную библиотеку, если в объекте библиотеки нет отношения. Затем функция создает системные пулы носителей , если они не существуют.

Синтаксис

DWORD AddNtmsMediaType(
  [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_MEDIA	Недопустимый тип носителя.
ERROR_INVALID_PARAMETER	Отсутствует тип носителя или идентификатор библиотеки.
ERROR_NOT_ENOUGH_MEMORY	Во время обработки произошел сбой выделения ресурсов.
ERROR_SUCCESS	Функция выполнена успешно.

Требования

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

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

DeleteNtmsMediaType

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

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