Fonction FwpmLayerGetSecurityInfoByKey0 (fwpmu.h)
La fonction FwpmLayerGetSecurityInfoByKey0 récupère une copie du descripteur de sécurité pour un objet de couche.
Syntaxe
DWORD FwpmLayerGetSecurityInfoByKey0(
[in] HANDLE engineHandle,
[in, optional] const GUID *key,
[in] SECURITY_INFORMATION securityInfo,
[out, optional] PSID *sidOwner,
[out, optional] PSID *sidGroup,
[out, optional] PACL *dacl,
[out, optional] PACL *sacl,
[out] PSECURITY_DESCRIPTOR *securityDescriptor
);
Paramètres
[in] engineHandle
Type : HANDLE
Handle pour une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.
[in, optional] key
Type : const GUID*
Identificateur unique de la couche. Pour obtenir la liste des valeurs GUID possibles, consultez Filtrage des identificateurs de couche.
[in] securityInfo
Type : SECURITY_INFORMATION
Type d’informations de sécurité à récupérer.
[out, optional] sidOwner
Type : PSID*
Identificateur de sécurité du propriétaire (SID) dans le descripteur de sécurité retourné.
[out, optional] sidGroup
Type : PSID*
Identificateur de sécurité du groupe principal (SID) dans le descripteur de sécurité retourné.
[out, optional] dacl
Type : PACL*
Liste de contrôle d’accès discrétionnaire (DACL) dans le descripteur de sécurité retourné.
[out, optional] sacl
Type : PACL*
Liste de contrôle d’accès système (SACL) dans le descripteur de sécurité retourné.
[out] securityDescriptor
Type : PSECURITY_DESCRIPTOR*
Descripteur de sécurité retourné.
Valeur retournée
Type : DWORD
Code/valeur de retour | Description |
---|---|
|
Le descripteur de sécurité a été récupéré avec succès. |
|
Une erreur spécifique à la plateforme de filtrage Windows (PAM). Pour plus d’informations, consultez Codes d’erreur PAM . |
|
Échec de la communication avec le moteur de pare-feu distant ou local. |
Notes
Si le paramètre de clé est NULL ou s’il s’agit d’un GUID NULL , cette fonction gère les informations de sécurité du conteneur de couches.
Le paramètre securityDescriptor retourné doit être libéré via un appel à FwpmFreeMemory0. Les quatre autres paramètres (facultatifs) retournés ne doivent pas être libérés, car ils pointent vers des adresses dans le paramètre securityDescriptor .
Cette fonction se comporte comme la fonction GetSecurityInfo Win32 standard. L’appelant a besoin des mêmes droits d’accès standard que ceux décrits dans la rubrique de référence GetSecurityInfo .
FwpmLayerGetSecurityInfoByKey0 est une implémentation spécifique de FwpmLayerGetSecurityInfoByKey. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .
Spécifications
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | fwpmu.h |
Bibliothèque | Fwpuclnt.lib |
DLL | Fwpuclnt.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour