Función FwpsAleEndpointEnum0 (fwpsk.h)

  • Artículo

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. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.
 

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 mediante una llamada 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 propiedad de extremo a las que apuntan las 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 ha realizado correctamente.
Otros códigos de estado
 Se produjo un error.

Comentarios

Para enumerar los puntos de conexión de ALE, el controlador de llamada primero debe obtener un identificador de enumeración mediante una llamada 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.

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 Value
Cliente mínimo compatible Disponible a partir de Windows 7.
Plataforma de destino Universal
Encabezado fwpsk.h (incluya Fwpsk.h)
Library Fwpkclnt.lib
IRQL PASSIVE_LEVEL

Consulte también

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0