Функция SaferCreateLevel (winsafer.h)

Статья
08/27/2023

Функция SaferCreateLevel открывает SAFER_LEVEL_HANDLE.

Синтаксис

BOOL SaferCreateLevel(
  [in]  DWORD              dwScopeId,
  [in]  DWORD              dwLevelId,
  [in]  DWORD              OpenFlags,
  [out] SAFER_LEVEL_HANDLE *pLevelHandle,
        LPVOID             lpReserved
);

Параметры

[in] dwScopeId

Область создаваемого уровня. В следующей таблице приводятся возможные значения.

Значение	Значение
SAFER_SCOPEID_MACHINE 1	Область созданного уровня выполняется по компьютерам.
SAFER_SCOPEID_USER 2	Область созданного уровня определяется пользователем.

[in] dwLevelId

Уровень открываемого дескриптора. В следующей таблице приводятся возможные значения.

Значение	Значение
SAFER_LEVELID_CONSTRAINED 0x10000	Программное обеспечение не может получить доступ к определенным ресурсам, таким как криптографические ключи и учетные данные, независимо от прав пользователя.
SAFER_LEVELID_DISALLOWED 0x00000	Программное обеспечение не запускается, независимо от прав пользователя.
SAFER_LEVELID_FULLYTRUSTED 0x40000	Права пользователя программного обеспечения определяются правами пользователя.
SAFER_LEVELID_NORMALUSER 0x20000	Позволяет выполнять программы от имени пользователя, у которых нет прав администратора или пользователя Power User . Программное обеспечение может получать доступ к ресурсам, доступным обычным пользователям.
SAFER_LEVELID_UNTRUSTED 0x01000	Позволяет выполнять программы только с доступом к ресурсам, предоставленным для открытия известных групп, блокируя доступ к привилегиям администратора и Power User , а также личным правам.

[in] OpenFlags

Это может быть следующее значение.

Значение	Значение
SAFER_LEVEL_OPEN 1

[out] pLevelHandle

Возвращенная SAFER_LEVEL_HANDLE. Завершив использование дескриптора, закройте его, вызвав функцию SaferCloseLevel .

lpReserved

Этот параметр зарезервирован для использования в будущем. Присвойте ему значение NULL.

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

Возвращает ненулевое значение при успешном выполнении или нулевое значение в противном случае.

Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winsafer.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll
Набор API	ext-ms-win-advapi32-safer-l1-1-0 (представлено в Windows 8)

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