Función FwpmLayerGetById0 (fwpmk.h)

La función FwpmLayerGetById0 recupera un objeto de capa.

Sintaxis

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

[in] engineHandle

Identificador de una sesión abierta en el motor de filtro. Llame a FwpmEngineOpen0 para abrir una sesión en el motor de filtro.

[in] id

Identificador de la capa deseada. Para obtener una lista de los valores posibles, consulte Identificadores de capa de filtrado en tiempo de ejecución en la documentación de WDK para la Plataforma de filtrado de Windows.

[out] layer

Información de la capa.

Código y valor devueltos	Descripción
ERROR_SUCCESS 0	La capa se recuperó correctamente.
FWP_E_* de código de error 0x80320001: 0x80320039	Error específico de la Plataforma de filtrado de Windows (PMA). Consulte códigos de error de PMA para obtener más información.
*RPC_ código de error** 0x80010001: 0x80010122	Error al comunicarse con el motor de firewall remoto o local.
otros códigos NTSTATUS	Error.

El autor de la llamada debe liberar el objeto devuelto por una llamada a FwpmFreeMemory0.

El autor de la llamada necesita FWPM_ACTRL_READ acceso a la capa. Consulte access Control para obtener más información.

fwpmLayerGetById0 es una implementación específica de FwpmLayerGetById. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows Vista.
de la plataforma de destino de	Universal
encabezado de	fwpmk.h
biblioteca de	fwpkclnt.lib
irQL	<= PASSIVE_LEVEL