Función FwpsAleEndpointEnum0 (fwpsk.h)

La función FwpsAleEndpointEnum0 enumera los puntos de conexión de cumplimiento de la capa de aplicación (ALE).

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

 

Sintaxis

NTSTATUS FwpsAleEndpointEnum0(
  [in]  HANDLE                        engineHandle,
  [in]  HANDLE                        enumHandle,
  [in]  UINT32                        numEntriesRequested,
  [out] FWPS_ALE_ENDPOINT_PROPERTIES0 ***entries,
  [out] UINT32                        *numEntriesReturned
);

Parámetros

[in] engineHandle

Identificador de una sesión abierta con el motor de filtro. Este identificador se obtiene cuando se abre una sesión llamando a FwpmEngineOpen0.

[in] enumHandle

Identificador de enumeración creado por una llamada anterior a FwpsAleEndpointDestroyEnumHandle0.

[in] numEntriesRequested

Número máximo de entradas de propiedad de punto de conexión que se van a devolver. El número real de entradas enumeradas se devuelve en numEntriesReturned. El número real es menor que el número solicitado solo si hay menos puntos de conexión que los solicitados.

[out] entries

Puntero a una matriz de punteros de estructura FWPS_ALE_ENDPOINT_PROPERTIES0. Cada estructura contiene las propiedades de un único punto de conexión. La matriz contiene tantos elementos como el valor devuelto en numEntriesReturned.

[out] numEntriesReturned

A cambio, el número de elementos de la matriz de estructuras de propiedades de punto de conexión a las que apunta entradas.

Valor devuelto

La función FwpsAleEndpointEnum0 devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	La función se realizó correctamente.
otros códigos de estado	Error.

Observaciones

Para enumerar los puntos de conexión de ALE, el controlador de llamada primero debe obtener un identificador de enumeración llamando a FwpsAleEndpointCreateEnumHandle0. El identificador devuelto está asociado a los parámetros especificados en el parámetro opcional enumTemplate de FwpsAleEndpointCreateEnumHandle0.

Después de obtener un identificador, el controlador de llamada puede llamar a FwpsAleEndpointEnum0 para obtener información sobre los puntos de conexión que coinciden con los parámetros de enumeración del identificador.

Tenga en cuenta que el campo localV4Address del FWPS_ALE_ENDPOINT_PROPERTIES0 devuelto está en orden de host-byte, mientras que localV6Address está en orden de red byte. Para usar la dirección IPv4 del campo localV4Address, debe llamar a htonl() en localV4Address para almacenarla en una estructura de in_addr y asegurarse de que el sockaddr tiene el formato correcto.

Cuando termine de examinar las propiedades del punto de conexión, el controlador de llamada debe llamar a FwpsAleEndpointDestroyEnumHandle0 para liberar los recursos del sistema asociados al identificador de enumeración.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows 7.
de la plataforma de destino de	Universal
encabezado de	fwpsk.h (incluya Fwpsk.h)
biblioteca de	Fwpkclnt.lib
irQL	PASSIVE_LEVEL

Consulte también

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

fwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0