Função FwpsAleEndpointCreateEnumHandle0 (fwpsk.h)

Artigo
02/07/2025

A função FwpsAleEndpointCreateEnumHandle0 cria um identificador que pode ser usado com outras funções de ponto de extremidade ALE (imposição de camada de aplicativo) para enumerar dados de ponto de extremidade.

ObservaçãoFwpsAleEndpointCreateEnumHandle0 é uma versão específica de FwpsAleEndpointCreateEnumHandle. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

Sintaxe

NTSTATUS FwpsAleEndpointCreateEnumHandle0(
  [in]           HANDLE                                 engineHandle,
  [in, optional] const FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                                 *enumHandle
);

Parâmetros

[in] engineHandle

Manipule para uma sessão aberta com o mecanismo de filtro. Esse identificador é obtido quando uma sessão é aberta chamando FwpmEngineOpen0.

[in, optional] enumTemplate

Um ponteiro para um FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 estrutura que contém parâmetros para restringir os resultados da enumeração do ponto de extremidade.

[out] enumHandle

O identificador de enumeração recém-criado.

Valor de retorno

A função FwpsAleEndpointCreateEnumHandle0 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.

Observações

Depois de usar o identificador adquirido chamando FwpsAleEndpointCreateEnumHandle0, o driver de texto explicativo deve liberar os recursos do sistema associados ao identificador chamando FwpsAleEndpointDestroyEnumHandle0.

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

Consulte também

FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointEnum0

Partilhar via