SaferGetPolicyInformation, fonction (winsafer.h)

Article
08/27/2023

La fonction SaferGetPolicyInformation obtient des informations sur une stratégie. Vous pouvez interroger pour obtenir plus d’informations sur la stratégie.

Syntaxe

BOOL SaferGetPolicyInformation(
  [in]  DWORD                   dwScopeId,
  [in]  SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in]  DWORD                   InfoBufferSize,
  [out] PVOID                   InfoBuffer,
  [out] PDWORD                  InfoBufferRetSize,
        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 à retourner. 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	Requêtes pour la liste de tous les niveaux définis dans une stratégie. Type de retour InfoBuffer : tableau DWORD de LevelIds.
SaferPolicyEnableTransparentEnforcement 2	Interroge 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	Requêtes pour le niveau de stratégie par défaut. Type de retour InfoBuffer : DWORD LevelId.
SaferPolicyEvaluateUserScope 4	Requêtes pour déterminer si les règles d’étendue utilisateur doivent être consultées pendant l’évaluation de la stratégie. Type de retour InfoBuffer : DWORD.
SaferPolicyScopeFlags 5	Requêtes pour déterminer si la stratégie consiste à ignorer les membres du groupe Administrateurs local. Type de retour InfoBuffer : DWORD.

[in] InfoBufferSize

Taille, en octets, du paramètre InfoBuffer .

[out] 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 .

[out] InfoBufferRetSize

Nombre d’octets dans le paramètre InfoBuffer qui ont été remplis avec des informations de stratégie.

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


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