SaferSetPolicyInformation, fonction (winsafer.h)

Article
03/04/2024

La fonction SaferSetPolicyInformation définit les contrôles de stratégie globaux.

Syntaxe

BOOL SaferSetPolicyInformation(
  [in] DWORD                   dwScopeId,
  [in] SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in] DWORD                   InfoBufferSize,
  [in] PVOID                   InfoBuffer,
       LPVOID                  lpReserved
);

Paramètres

[in] dwScopeId

Étendue de la requête. Le tableau suivant répertorie les valeurs possibles.

Value	Signification
SAFER_SCOPEID_MACHINE 1	L’étendue de la requête est par ordinateur.
SAFER_SCOPEID_USER 2	L’étendue de la requête est par utilisateur.

[in] SaferPolicyInfoClass

Valeur d’énumération SAFER_POLICY_INFO_CLASS qui spécifie le type d’informations de stratégie à définir. La valeur spécifiée détermine la taille et le type du paramètre InfoBuffer . Le tableau suivant répertorie les valeurs possibles.

Value	Signification
SaferPolicyLevelList 1	Définit la liste de tous les niveaux définis dans une stratégie. Type de retour InfoBuffer : tableau DWORD de LevelIds.
SaferPolicyEnableTransparentEnforcement 2	Définit la valeur de stratégie pour déterminer si la vérification des DLL est activée. Type de retour InfoBuffer : DWORD Boolean.
SaferPolicyDefaultLevel 3	Définit le niveau de stratégie par défaut. Type de retour InfoBuffer : DWORD LevelId.
SaferPolicyEvaluateUserScope 4	Définit si les règles d’étendue utilisateur doivent être consultées lors de l’évaluation de la stratégie. Type de retour InfoBuffer : DWORD.
SaferPolicyScopeFlags 5	Définit si la stratégie doit ignorer les membres du groupe Administrateurs local. Type de retour InfoBuffer : DWORD.

[in] InfoBufferSize

Taille, en octets, du paramètre InfoBuffer .

[in] InfoBuffer

Mémoire tampon pour contenir les résultats de la requête. La taille et le type des informations retournées sont déterminés par le paramètre SaferPolicyInfoClass . Pour connaître le type des informations retournées pour chaque valeur possible du paramètre SaferPolicyInfoClass , consultez le paramètre SaferPolicyInfoClass .

lpReserved

Réservé pour un usage futur. Ce paramètre doit être défini sur NULL.

Valeur retournée

TRUE si la fonction réussit ; sinon, FALSE. 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