Funzione FwpsAleEndpointEnum0 (fwpsk.h)

  • Articolo

La funzione FwpsAleEndpointEnum0 enumera gli endpoint di imposizione del livello applicazione (ALE).

NotaFwpsAleEndpointEnum0 è una versione specifica di FwpsAleEndpointEnum. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.
 

Sintassi

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

Parametri

[in] engineHandle

Handle per una sessione aperta con il motore di filtro. Questo handle viene ottenuto quando una sessione viene aperta chiamando FwpmEngineOpen0.

[in] enumHandle

Handle di enumerazione creato da una chiamata precedente a FwpsAleEndpointDestroyEnumHandle0.

[in] numEntriesRequested

Numero massimo di voci di proprietà dell'endpoint da restituire. Il numero effettivo di voci enumerate viene restituito in numEntriesReturned. Il numero effettivo è minore del numero richiesto solo se sono presenti meno endpoint rispetto a quelli richiesti.

[out] entries

Puntatore a una matrice di puntatori FWPS_ALE_ENDPOINT_PROPERTIES0 struttura. Ogni struttura contiene le proprietà di un singolo endpoint. La matrice contiene tutti gli elementi restituiti in numEntriesReturned.

[out] numEntriesReturned

In caso di restituzione, il numero di elementi nella matrice di strutture di proprietà dell'endpoint a cui puntano le voci.

Valore restituito

La funzione FwpsAleEndpointEnum0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito Descrizione
STATUS_SUCCESS
 Funzione completata.
Altri codici di stato
 Si è verificato un errore.

Commenti

Per enumerare gli endpoint ALE, il driver di callout deve prima ottenere un handle di enumerazione chiamando FwpsAleEndpointCreateEnumHandle0. L'handle restituito è associato a qualsiasi parametro specificato nel parametro enumTemplate facoltativo di FwpsAleEndpointCreateEnumHandle0.

Dopo aver ottenuto un handle, il driver del callout può chiamare FwpsAleEndpointEnum0 per ottenere informazioni sugli endpoint che corrispondono ai parametri di enumerazione dell'handle.

Al termine dell'analisi delle proprietà dell'endpoint, il driver del callout deve chiamare FwpsAleEndpointDestroyEnumHandle0 per rilasciare le risorse di sistema associate all'handle di enumerazione.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 7.
Piattaforma di destinazione Universale
Intestazione fwpsk.h (include Fwpsk.h)
Libreria Fwpkclnt.lib
IRQL PASSIVE_LEVEL

Vedi anche

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0