Fonction FwpmProviderSetSecurityInfoByKey0 (fwpmu.h)
La fonction FwpmProviderSetSecurityInfoByKey0 définit des informations de sécurité spécifiées dans le descripteur de sécurité d’un objet fournisseur.
Syntaxe
DWORD FwpmProviderSetSecurityInfoByKey0(
[in] HANDLE engineHandle,
[in, optional] const GUID *key,
[in] SECURITY_INFORMATION securityInfo,
[in, optional] const SID *sidOwner,
[in, optional] const SID *sidGroup,
[in, optional] const ACL *dacl,
[in, optional] const ACL *sacl
);
Paramètres
[in] engineHandle
Type : HANDLE
Gérer pour une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.
[in, optional] key
Type : GUID const*
Identificateur unique du fournisseur. Il s’agit du MÊME GUID que celui spécifié lorsque l’application a appelé FwpmProviderAdd0 pour cet objet.
[in] securityInfo
Type : SECURITY_INFORMATION
Type d’informations de sécurité à définir.
[in, optional] sidOwner
Type : const SID*
Identificateur de sécurité (SID) du propriétaire à définir dans le descripteur de sécurité.
[in, optional] sidGroup
Type : const SID*
SID du groupe à définir dans le descripteur de sécurité.
[in, optional] dacl
Type : ACL* const
Liste de contrôle d’accès discrétionnaire (DACL) à définir dans le descripteur de sécurité.
[in, optional] sacl
Type : ACL* const
Liste de contrôle d’accès système (SACL) à définir dans le descripteur de sécurité.
Valeur retournée
Type : DWORD
Code/valeur de retour | Description |
---|---|
|
Le descripteur de sécurité a été défini avec succès. |
|
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. |
Remarques
Si le paramètre de clé a la valeur NULL ou s’il s’agit d’un GUID NULL , cette fonction gère les informations de sécurité du conteneur de fournisseurs.
Cette fonction ne peut pas être appelée à partir d’une transaction. Il échoue avec FWP_E_TXN_IN_PROGRESS. Pour plus d’informations sur les transactions, consultez Gestion des objets.
Cette fonction peut être appelée dans une session dynamique si l’objet correspondant a été ajouté au cours de la même session. Si cette fonction est appelée pour un objet qui a été ajouté au cours d’une autre session dynamique, elle échoue avec FWP_E_WRONG_SESSION. Si cette fonction est appelée pour un objet qui n’a pas été ajouté pendant une session dynamique, elle échoue avec FWP_E_DYNAMIC_SESSION_IN_PROGRESS.
Cette fonction se comporte comme la fonction Win32 SetSecurityInfo standard. L’appelant a besoin des mêmes droits d’accès standard que ceux décrits dans la rubrique de référence SetSecurityInfo .
FwpmProviderSetSecurityInfoByKey0 est une implémentation spécifique de FwpmProviderSetSecurityInfoByKey. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows .
Configuration requise
Condition requise | Valeur |
---|---|
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