Función SaferCreateLevel (winsafer.h)

Artículo
03/04/2024

La función SaferCreateLevel abre un SAFER_LEVEL_HANDLE.

Sintaxis

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

Parámetros

[in] dwScopeId

Ámbito del nivel que se va a crear. En la siguiente tabla se muestran los valores posibles.

Valor	Significado
SAFER_SCOPEID_MACHINE 1	El ámbito del nivel creado es por equipo.
SAFER_SCOPEID_USER 2	El ámbito del nivel creado es el usuario.

[in] dwLevelId

Nivel del identificador que se va a abrir. En la siguiente tabla se muestran los valores posibles.

Valor	Significado
SAFER_LEVELID_CONSTRAINED 0x10000	El software no puede acceder a determinados recursos, como claves criptográficas y credenciales, independientemente de los derechos de usuario del usuario.
SAFER_LEVELID_DISALLOWED 0x00000	El software no se ejecutará, independientemente de los derechos de usuario del usuario.
SAFER_LEVELID_FULLYTRUSTED 0x40000	Los derechos de usuario de software están determinados por los derechos de usuario del usuario.
SAFER_LEVELID_NORMALUSER 0x20000	Permite que los programas se ejecuten como un usuario que no tenga derechos de usuario administrador o usuario avanzado . El software puede acceder a los recursos accesibles por los usuarios normales.
SAFER_LEVELID_UNTRUSTED 0x01000	Permite que los programas se ejecuten con acceso solo a los recursos concedidos para abrir grupos conocidos, bloquear el acceso a privilegios de administrador y usuario avanzado y derechos concedidos personalmente.

[in] OpenFlags

Puede ser el siguiente valor.

Valor	Significado
SAFER_LEVEL_OPEN 1

[out] pLevelHandle

SAFER_LEVEL_HANDLE devuelto. Cuando haya terminado de usar el identificador, ciérrelo llamando a la función SaferCloseLevel .

lpReserved

Este parámetro se reserva para uso futuro. Establézcalo en NULL.

Valor devuelto

Devuelve un valor distinto de cero si es correcto o cero de lo contrario.

Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winsafer.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll
Conjunto de API	ext-ms-win-advapi32-safer-l1-1-0 (introducido en Windows 8)