Partager via

Fonction FwpmLayerGetById0 (fwpmu.h)

  • Article

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

Syntaxe

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

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

Type : UINT16

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

Type : FWPM_LAYER0**

Informations de couche.

Valeur retournée

Type : DWORD

Code/valeur de retour Description
ERROR_SUCCESS
0
 La couche a été récupérée avec succès.
code d’erreur FWP_E_*
0x80320001—0x80320039
 Une erreur spécifique à la plateforme de filtrage Windows (PAM). Pour plus d’informations, consultez Codes d’erreur PAM .
code d’erreur RPC_*
0x80010001—0x80010122
 Échec de la communication avec le moteur de pare-feu distant ou local.

Notes

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

L’appelant a besoin d’un accès FWPM_ACTRL_READ à la couche. Pour plus d’informations, consultez Access Control.

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

Voir aussi

FWPM_LAYER0

Identificateurs de couche de filtrage au moment de l’exécution