SaferCreateLevel, fonction (winsafer.h)

Article
03/04/2024

La fonction SaferCreateLevel ouvre un SAFER_LEVEL_HANDLE.

Syntaxe

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

Paramètres

[in] dwScopeId

Étendue du niveau à créer. Le tableau suivant répertorie les valeurs possibles.

Value	Signification
SAFER_SCOPEID_MACHINE 1	L’étendue du niveau créé est par ordinateur.
SAFER_SCOPEID_USER 2	L’étendue du niveau créé est par utilisateur.

[in] dwLevelId

Niveau de la poignée à ouvrir. Le tableau suivant répertorie les valeurs possibles.

Value	Signification
SAFER_LEVELID_CONSTRAINED 0x10000	Les logiciels ne peuvent pas accéder à certaines ressources, telles que les clés de chiffrement et les informations d’identification, quels que soient les droits d’utilisateur de l’utilisateur.
SAFER_LEVELID_DISALLOWED 0x00000	Le logiciel ne s’exécute pas, quels que soient les droits de l’utilisateur.
SAFER_LEVELID_FULLYTRUSTED 0x40000	Les droits de l’utilisateur logiciel sont déterminés par les droits d’utilisateur de l’utilisateur.
SAFER_LEVELID_NORMALUSER 0x20000	Permet aux programmes de s’exécuter en tant qu’utilisateur qui ne dispose pas de droits d’administrateur ou d’utilisateur avec pouvoir . Les logiciels peuvent accéder aux ressources accessibles par les utilisateurs normaux.
SAFER_LEVELID_UNTRUSTED 0x01000	Permet aux programmes de s’exécuter avec l’accès uniquement aux ressources accordées pour ouvrir des groupes connus, bloquant l’accès aux privilèges d’administrateur et d’utilisateur autonome et aux droits accordés personnellement.

[in] OpenFlags

Il peut s’agir de la valeur suivante.

Valeur	Signification
SAFER_LEVEL_OPEN 1

[out] pLevelHandle

SAFER_LEVEL_HANDLE retourné. Une fois que vous avez terminé d’utiliser le handle, fermez-le en appelant la fonction SaferCloseLevel .

lpReserved

Ce paramètre est réservé à un usage futur. Définissez-le sur NULL.

Valeur retournée

Retourne une valeur différente de zéro en cas de réussite ou de zéro dans le cas contraire.

Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winsafer.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll
Ensemble d’API	ext-ms-win-advapi32-safer-l1-1-0 (introduit dans Windows 8)

Partager via