Partager via

FwpmProviderContextSetSecurityInfoByKey0, fonction (fwpmk.h)

  • Article

La fonction FwpmProviderContextSetSecurityInfoByKey0 définit les informations de sécurité spécifiées dans le descripteur de sécurité d’un objet de contexte de fournisseur.

Syntaxe

NTSTATUS FwpmProviderContextSetSecurityInfoByKey0(
  [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

Gérer une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session au moteur de filtre.

[in, optional] key

Identificateur unique de l’objet de contexte du fournisseur. Il s’agit d’un pointeur vers le même GUID spécifié lorsque l’application appelée FwpmProviderContextAdd0 pour cet objet.

[in] securityInfo

Type d’informations de sécurité à définir.

[in, optional] sidOwner

Identificateur de sécurité (SID) du propriétaire à définir dans le descripteur de sécurité.

[in, optional] sidGroup

SID du groupe à définir dans le descripteur de sécurité.

[in, optional] dacl

Liste de contrôle d’accès discrétionnaire (DACL) à définir dans le descripteur de sécurité.

[in, optional] sacl

Liste de contrôle d’accès système (SACL) à définir dans le descripteur de sécurité.

Valeur de retour

Retourner le code/la valeur Description
ERROR_SUCCESS
0		 Le descripteur de sécurité a été défini avec succès.
code d’erreur FWP_E_*
0x80320001 — 0x80320039		 Erreur spécifique à la plateforme de filtrage Windows (PAM). Consultez codes d’erreur PAM pour plus d’informations.
code d’erreur RPC_*
0x80010001 — 0x80010122		 Échec de la communication avec le moteur de pare-feu distant ou local.
autres codes NTSTATUS Une erreur s’est produite.

Remarques

Si le paramètre clé est NULL ou s’il s’agit d’un GUID NULL, cette fonction gère les informations de sécurité du conteneur de contextes de fournisseur.

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 peut être appelée dans une session dynamique si l’objet correspondant a été ajouté pendant la même session. Si cette fonction est appelée pour un objet qui a été ajouté pendant une session dynamique différente, 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 Standard Win32 SetSecurityInfo. L’appelant a besoin des mêmes droits d’accès standard que ceux décrits dans la rubrique de référence SetSecurityInfo.

FwpmProviderContextSetSecurityInfoByKey0 est une implémentation spécifique de FwpmProviderContextSetSecurityInfoByKey. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows Vista.
plateforme cible Universel
d’en-tête fwpmk.h
bibliothèque fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Voir aussi