Função FwpsAleEndpointEnum0 (fwpsk.h)

  • Artigo

A função FwpsAleEndpointEnum0 enumera pontos de extremidade ALE (imposição da camada de aplicativo).

ObservaçãoFwpsAleEndpointEnum0 é uma versão específica de FwpsAleEndpointEnum. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.
 

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 será menor que o número solicitado somente se houver menos pontos de extremidade do que o solicitado.

[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 apontadas por entradas.

Retornar valor

A função FwpsAleEndpointEnum0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno Descrição
STATUS_SUCCESS
 A função foi bem-sucedida.
Outros códigos de status
 Ocorreu um erro.

Comentários

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 todos os parâmetros especificados no parâmetro enumTemplate 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.

Quando terminar de examinar as propriedades do ponto de extremidade, o driver de texto explicativo deverá chamar FwpsAleEndpointDestroyEnumHandle0 para liberar os recursos do sistema associados ao identificador de enumeração.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 7.
Plataforma de Destino Universal
Cabeçalho fwpsk.h (inclua Fwpsk.h)
Biblioteca Fwpkclnt.lib
IRQL PASSIVE_LEVEL

Confira também

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0