Partager via

FwpmLayerGetById0, fonction (fwpmk.h)

  • Article

La fonction FwpmLayerGetById0 récupère un objet de couche.

Syntaxe

NTSTATUS FwpmLayerGetById0(
  [in]  HANDLE      engineHandle,
  [in]  UINT16      id,
  [out] FWPM_LAYER0 **layer
);

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] id

Identificateur de la couche souhaitée. Pour obtenir la liste des valeurs possibles, consultez identificateurs de couche de filtrage au moment de l’exécution dans la documentation WDK pour la plateforme de filtrage Windows.

[out] layer

Informations de couche.

Valeur de retour

Retourner le code/la valeur Description
ERROR_SUCCESS
0		 La couche a été récupérée 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

L’appelant doit libérer l’objet retourné par un appel à FwpmFreeMemory0.

L’appelant a besoin de FWPM_ACTRL_READ'accès à la couche. Pour plus d’informations, consultez contrôle d’accès.

FwpmLayerGetById0 est une implémentation spécifique de FwpmLayerGetById. 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