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

  • Статья

Функция 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)