Fonction FwpmLayerSetSecurityInfoByKey0 (fwpmu.h)
La fonction FwpmLayerSetSecurityInfoByKey0 définit les informations de sécurité spécifiées dans le descripteur de sécurité d’un objet de couche.
Syntaxe
DWORD FwpmLayerSetSecurityInfoByKey0(
[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
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é à 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 : const ACL*
Liste de contrôle d’accès discrétionnaire (DACL) à définir dans le descripteur de sécurité.
[in, optional] sacl
Type : const ACL*
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é correctement défini. |
|
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.
Cette fonction ne peut pas être appelée à partir d’une transaction. Elle échoue avec FWP_E_TXN_IN_PROGRESS. Pour plus d’informations sur les transactions, consultez Gestion des objets.
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 .
FwpmLayerSetSecurityInfoByKey0 est une implémentation spécifique de FwpmLayerSetSecurityInfoByKey. 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 |