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

  • Статья

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

Функция SetNtmsObjectInformation изменяет структуру информации указанного объекта.

Синтаксис

DWORD SetNtmsObjectInformation(
  [in] HANDLE                   hSession,
  [in] LPNTMS_GUID              lpObjectId,
  [in] LPNTMS_OBJECTINFORMATION lpInfo
);

Параметры

[in] hSession

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

[in] lpObjectId

Уникальный идентификатор объекта RSM.

[in] lpInfo

Указатель на структуру NTMS_OBJECTINFORMATION .

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

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

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

Комментарии

Перед использованием SetNtmsObjectInformation необходимо задать размер и тип сведений.

Все доступные для записи свойства объекта считываются из структуры NTMS_OBJECTINFORMATION и записываются в базу данных без учета любых операций записи, которые выполнялись между временем, когда это приложение называется функцией GetNtmsObjectInformation и функцией SetNtmsObjectInformation . Из-за этого вы можете потерять изменения.

Чтобы избежать непредсказуемых результатов, приложения должны вызывать GetNtmsObjectInformation перед вызовом SetNtmsObjectInformation. Как отмечалось выше, SetNtmsObjectInformation обновляет все записываемые члены, поэтому приложение отвечает за предоставление значений для всех записываемых элементов.

Ниже приведен список объектов с элементами, которые можно обновить.

Объект Элементы
NTMS_CHANGER szDescription Требуется NTMS_MODIFY_ACCESS в библиотеку.

Windows XP: Права доступа не требуются.
NTMS_CHANGER_TYPE szDescription Требуется NTMS_MODIFY_ACCESS на компьютер.

Windows XP: Права доступа не требуются.
NTMS_COMPUTER dwMediaPoolPolicy
 
DwLibRequestFlags
 
dwLibRequestPurgeTime
 
dwOpRequestFlags
 
dwOpRequestPurgeTime
 
szDescription Требуется NTMS_MODIFY_ACCESS на компьютер.

Windows XP: Права доступа не требуются.
NTMS_DRIVE dwDeferDismountDelay
 
szDescription Требуется NTMS_MODIFY_ACCESS в библиотеку.

Windows XP: Права доступа не требуются.
NTMS_DRIVE_TYPE szDescription Требуется NTMS_MODIFY_ACCESS на компьютер.

Windows XP: Права доступа не требуются.
NTMS_IEDOOR MaxOpenSecs
 
szDescription Требуется NTMS_MODIFY_ACCESS в библиотеку.

Windows XP: Права доступа не требуются.
NTMS_IEPORT MaxExtendSecs
 
szDescription Требуется NTMS_MODIFY_ACCESS в библиотеку.

Windows XP: Права доступа не требуются.
NTMS_LIBRARY Автосохранения
 
dwCleanerUsesRemaining
 
dwFlags
 
InventoryMethod
 
szDescription
 
szName Требуется NTMS_CONTROL_ACCESS в библиотеку.
NTMS_LIBREQUEST szDescription Требуется NTMS_MODIFY_ACCESS в библиотеку.

Windows XP: Права доступа не требуются.
NTMS_LOGICAL_MEDIA szDescription
 
szName Требуется NTMS_MODIFY_ACCESS в пул носителей логического носителя.

Windows XP: Права доступа не требуются.
NTMS_MEDIA_POOL AllocationPolicy
 
DeallocationPolicy
 
dwMaxAllocates
 
MediaType
 
szDescription
 
szName Требуется NTMS_MODIFY_ACCESS в пул носителей.

Windows XP: Требуется NTMS_CONTROL_ACCESS в пул носителей.
NTMS_MEDIA_TYPE szDescription Требуется NTMS_MODIFY_ACCESS на компьютер.

Windows XP: Права доступа не требуются.
NTMS_OPREQUEST szDescription Требуется NTMS_MODIFY_ACCESS на компьютер.

Windows XP: Права доступа не требуются.
NTMS_PARTITION szName
 
szDescription Требуется NTMS_MODIFY_ACCESS в пул носителей на стороне.

Windows XP: Требуется NTMS_CONTROL_ACCESS в пул носителей на стороне.
NTMS_PHYSICAL_MEDIA szDescription
 
szName Требуется NTMS_MODIFY_ACCESS в пул носителей.

Windows XP: Права доступа не требуются.
NTMS_STORAGESLOT szDescription Требуется NTMS_MODIFY_ACCESS в библиотеку.

Windows XP: Права доступа не требуются.

Требования

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

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

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Функции управления объектами