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

Статья
11/20/2024

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

Функция getNtmsObjectInformation возвращает структуру сведений объекта для указанного объекта.

Синтаксис

DWORD GetNtmsObjectInformationA(
  [in]  HANDLE                    hSession,
  [in]  LPNTMS_GUID               lpObjectId,
  [out] LPNTMS_OBJECTINFORMATIONA lpInfo
);

Параметры

[in] hSession

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

[in] lpObjectId

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

[out] lpInfo

Указатель на структуру NTMS_OBJECTINFORMATION, которая получает сведения об объекте.

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

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

Ценность	Значение
ERROR_ACCESS_DENIED	NTMS_USE_ACCESS объекту или его контейнеру запрещено. Другие ошибки безопасности также возможны, но они указывают на ошибку подсистемы безопасности. Windows XP: нет необходимых прав доступа.
ERROR_INVALID_HANDLE	Дескриптор сеанса отсутствует или недопустим.
ERROR_INVALID_PARAMETER	Отсутствует идентификатор объекта или структура сведений, а размер или тип объекта недействителен.
ERROR_NOT_ENOUGH_MEMORY	При обработке произошел сбой выделения.
ERROR_OBJECT_NOT_FOUND	Недопустимый идентификатор объекта.
ERROR_SUCCESS	Функция была успешной.

Замечания

Перед использованием функции GetNtmsObjectInformation необходимо правильно задать размер и тип структуры информации в параметре lpInfo.

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

Ниже приведен список объектов, требующих специальных прав доступа.

Объект	Доступ
NTMS_CHANGER	Требуется NTMS_USE_ACCESS библиотеке.
NTMS_CHANGER_TYPE	Требуется NTMS_USE_ACCESS на компьютер.
NTMS_COMPUTER	Требуется NTMS_USE_ACCESS на компьютер.
NTMS_DRIVE	Требуется NTMS_USE_ACCESS библиотеке.
NTMS_DRIVE_TYPE	Требуется NTMS_USE_ACCESS на компьютер.
NTMS_IEDOOR	Требуется NTMS_USE_ACCESS библиотеке.
NTMS_IEPORT	Требуется NTMS_USE_ACCESS библиотеке.
NTMS_LIBRARY	Требуется NTMS_USE_ACCESS библиотеке.
NTMS_LIBREQUEST	Требуется NTMS_USE_ACCESS библиотеке.
NTMS_LOGICAL_MEDIA	Требуется NTMS_USE_ACCESS в пул носителей логического носителя.
NTMS_MEDIA_TYPE	Требуется NTMS_USE_ACCESS на компьютер.
NTMS_OPREQUEST	Требуется NTMS_USE_ACCESS на компьютер.
NTMS_PARTITION	Требуется NTMS_USE_ACCESS в пул носителей на стороне.
NTMS_PHYSICAL_MEDIA	Требуется NTMS_USE_ACCESS в пул мультимедиа.
NTMS_STORAGESLOT	Требуется NTMS_USE_ACCESS библиотеке.

Заметка

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

Требования

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

См. также

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

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

SetNtmsObjectInformation

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