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

  • Статья

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

Функция GetNtmsObjectSecurity считывает дескриптор безопасности для указанного объекта RSM.

Синтаксис

DWORD GetNtmsObjectSecurity(
  [in]  HANDLE               hSession,
  [in]  LPNTMS_GUID          lpObjectId,
  [in]  DWORD                dwType,
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR lpSecurityDescriptor,
  [in]  DWORD                nLength,
  [out] LPDWORD              lpnLengthNeeded
);

Параметры

[in] hSession

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

[in] lpObjectId

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

[in] dwType

Тип объекта. Список типов объектов см. в разделе NtmsObjectsTypes.

[in] RequestedInformation

Значение SECURITY_INFORMATION , указывающее запрошенные данные безопасности.

[out] lpSecurityDescriptor

Указатель на структуру SECURITY_DESCRIPTOR , получающую дескриптор безопасности.

[in] nLength

Длина дескриптора.

[out] lpnLengthNeeded

Требуемая длина буфера, если он недостаточно велик для дескриптора безопасности, в байтах.

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

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

Значение Значение
ERROR_ACCESS_DENIED
 READ_CONTROL доступ к объекту запрещен.

Windows XP: Права доступа не требуются.
ERROR_DATABASE_FAILURE
 База данных недоступна или повреждена.
ERROR_INVALID_HANDLE
 Дескриптор сеанса отсутствует или недопустим.
ERROR_INVALID_PARAMETER
 Идентификатор объекта отсутствует.
ERROR_NO_SECURITY_ON_OBJECT
 Для этого объекта нет сведений о безопасности.
ERROR_OBJECT_NOT_FOUND
 Недопустимый идентификатор объекта.
ERROR_SUCCESS
 Функция выполнена успешно.

Комментарии

Безопасность RSM использует стандартные дескрипторы безопасности и информационные элементы. Это позволяет использовать стандартные диалоговые окна безопасности для выбора безопасности RSM. Дополнительные сведения см. в разделе Функция SetPrivateObjectSecurity . Дополнительные сведения о безопасности RSM см. в разделе Безопасность RSM.

Требования

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

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

EnumerateNtmsObject

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

SetNtmsObjectSecurity