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

Статья
11/20/2024

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

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

Синтаксис

DWORD SetNtmsObjectInformationW(
  [in] HANDLE                    hSession,
  [in] LPNTMS_GUID               lpObjectId,
  [in] LPNTMS_OBJECTINFORMATIONW lpInfo
);

Параметры

[in] hSession

Обработка сеанса, возвращаемого функцией OpenNtmsSess ion.

[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	требуется NTMS_MODIFY_ACCESS на компьютер. Windows XP: Нет необходимых прав доступа.
NTMS_COMPUTER	dwMediaPoolPolicy dwLibRequestFlags dwLibRequestPurgeTime dwOpRequestFlags dwOpRequestPurgeTime требуется NTMS_MODIFY_ACCESS на компьютер. Windows XP: Нет необходимых прав доступа.
NTMS_DRIVE	dwDeferDismountDelay szDescription Требуется NTMS_MODIFY_ACCESS библиотеке. Windows XP: Нет необходимых прав доступа.
NTMS_DRIVE_TYPE	требуется 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	требуется NTMS_MODIFY_ACCESS на компьютер. Windows XP: Нет необходимых прав доступа.
NTMS_OPREQUEST	требуется 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: Нет необходимых прав доступа.

Заметка

Заголовок ntmsapi.h определяет SetNtmsObjectInformation как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	ntmsapi.h
библиотеки	Ntmsapi.lib
DLL	Ntmsapi.dll

См. также

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

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

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