Leer en inglés

Compartir a través de

Función FwpmProviderContextEnum3 (fwpmu.h)

  • Artículo

Devuelve la siguiente página de resultados del enumerador de contexto del proveedor.

Sintaxis

DWORD FwpmProviderContextEnum3(
  HANDLE                 engineHandle,
  HANDLE                 enumHandle,
  UINT32                 numEntriesRequested,
  FWPM_PROVIDER_CONTEXT3 ***entries,
  UINT32                 *numEntriesReturned
);

Parámetros

engineHandle

Tipo: _In_ HANDLE

Identificador de una sesión abierta con el motor de filtros. Para abrir una sesión con el motor de filtro, llame a FwpmEngineOpen0.

enumHandle

Tipo: _In_ HANDLE

Identificador de una enumeración de eventos de red creada por una llamada a FwpmProviderContextCreateEnumHandle0.

numEntriesRequested

Tipo: _In_ UINT32

Número de objetos de contexto de proveedor solicitados.

entries

Tipo: _Outptr_result_buffer_(*numEntriesReturned) FWPM_PROVIDER_CONTEXT3***

Objetos de contexto de proveedor devueltos.

numEntriesReturned

Tipo: _Out_ UINT32*

Número de objetos de contexto de proveedor devueltos.

Valor devuelto

Tipo: DWORD*

Código o valor devuelto Descripción
ERROR_SUCCESS
0		 Los contextos del proveedor se enumeraron correctamente.
código de error FWP_E_*
0x80320001: 0x80320039		 Error específico de la Plataforma de filtrado de Windows (PMA). Para obtener más información, consulte Códigos de error de PMA.
RPC_* código de error*
0x80010001: 0x80010122		 Error al comunicarse con el motor de firewall remoto o local.

Comentarios

Si numEntriesReturned es menor que numEntriesRequested, se agota la enumeración.

Debe liberar la matriz de entradas devuelta (pero no las entradas individuales) llamando a FwpmFreeMemory0.

Una llamada posterior que usa el mismo parámetro enumHandle devolverá el siguiente conjunto de eventos después de los del último búfer de salida.

FwpmProviderContextEnum3 funciona en una instantánea de los contextos del proveedor tomados en el momento en que se creó el identificador de enumeración.

Requisitos

Requisito Valor
Header fwpmu.h
Library Fwpuclnt.lib
Archivo DLL Fwpuclnt.dll