FwpmNetEventsGetSecurityInfo0, fonction (fwpmu.h)

Article
06/27/2024

La fonction FwpmNetEventsGetSecurityInfo0 récupère une copie du descripteur de sécurité pour un objet d’événement réseau.

Syntaxe

DWORD FwpmNetEventsGetSecurityInfo0(
  [in]            HANDLE               engineHandle,
  [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

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

[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 de retour

Type : DWORD

Retourner le code/la valeur	Description
ERROR_SUCCESS 0	Le descripteur de sécurité a été récupéré 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.

Remarques

Le paramètre securityDescriptor retourné doit être libéré par le biais d’un appel à FwpmFreeMemory0. Les quatre autres paramètres retournés (facultatifs) 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 Standard Win32 GetSecurityInfo. L’appelant a besoin des mêmes droits d’accès standard que décrits dans la rubrique de référence GetSecurityInfo.

FwpmNetEventsGetSecurityInfo0 est une implémentation spécifique de FwpmNetEventsGetSecurityInfo. 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	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	fwpmu.h
bibliothèque	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Voir aussi

FwpmNetEventsSetSecurityInfo0

Partager via