Função FwpsAleEndpointEnum0 (fwpsk.h)
A função FwpsAleEndpointEnum0 enumera pontos de extremidade ALE (imposição de camada de aplicativo).
Sintaxe
NTSTATUS FwpsAleEndpointEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPS_ALE_ENDPOINT_PROPERTIES0 ***entries,
[out] UINT32 *numEntriesReturned
);
Parâmetros
[in] engineHandle
O identificador de uma sessão aberta com o mecanismo de filtro. Esse identificador é obtido quando uma sessão é aberta chamando FwpmEngineOpen0.
[in] enumHandle
O identificador de enumeração criado por uma chamada anterior para FwpsAleEndpointDestroyEnumHandle0.
[in] numEntriesRequested
O número máximo de entradas de propriedade do ponto de extremidade a serem retornadas. O número real de entradas enumeradas é retornado em numEntriesReturned . O número real é menor que o número solicitado somente se houver menos pontos de extremidade do que os solicitados.
[out] entries
Um ponteiro para uma matriz de ponteiros de estrutura FWPS_ALE_ENDPOINT_PROPERTIES0. Cada estrutura contém as propriedades de um único ponto de extremidade. A matriz contém tantos elementos quanto o valor retornado em numEntriesReturned.
[out] numEntriesReturned
No retorno, o número de elementos na matriz de estruturas de propriedade do ponto de extremidade apontado por entradas.
Valor de retorno
A função FwpsAleEndpointEnum0 retorna um dos seguintes códigos NTSTATUS.
| Código de retorno | Descrição |
|---|---|
|
A função foi bem-sucedida. |
|
Ocorreu um erro. |
Observações
Para enumerar pontos de extremidade ALE, o driver de texto explicativo deve primeiro obter um identificador de enumeração chamando FwpsAleEndpointCreateEnumHandle0. O identificador retornado está associado a quaisquer parâmetros especificados no parâmetro enumTemplate de opcional de FwpsAleEndpointCreateEnumHandle0.
Depois de obter um identificador, o driver de texto explicativo pode chamar FwpsAleEndpointEnum0 para obter informações sobre os pontos de extremidade que correspondem aos parâmetros de enumeração do identificador.
Observe que o campo localV4Address do FWPS_ALE_ENDPOINT_PROPERTIES0 retornado está em ordem de byte de host, enquanto o localV6Address está em ordem de byte de rede. Para usar o endereço IPv4 do campo localV4Address, você deve chamar htonl() no localV4Address para armazená-lo em uma estrutura in_addr e garantir que o sockaddr esteja formatado corretamente.
Quando terminar de examinar as propriedades do ponto de extremidade, o driver de texto explicativo deve chamar FwpsAleEndpointDestroyEnumHandle0 para liberar os recursos do sistema associados ao identificador de enumeração.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 7. |
| da Plataforma de Destino | Universal |
| cabeçalho | fwpsk.h (inclua Fwpsk.h) |
| biblioteca | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |