Condividi tramite


Funzione FwpsNetBufferListRetrieveContext0 (fwpsk.h)

La funzione FwpsNetBufferListRetrieveContext0 recupera il contesto associato a un elenco di buffer di rete contrassegnato in un altro livello.

NotaFwpsNetBufferListRetrieveContext0 è una versione specifica di FwpsNetBufferListRetrieveContext. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .
 

Sintassi

NTSTATUS FwpsNetBufferListRetrieveContext0(
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      UINT64          contextTag,
  [in]      BOOLEAN         removeContext,
  [in]      UINT32          flags,
  [out]     UINT64          *context
);

Parametri

[in, out] netBufferList

Elenco di buffer di rete che indica uno o più pacchetti di interesse per il driver di callout. Se removeContext è impostato, l'elenco del buffer di rete restituito avrà rimosso il contesto.

[in] contextTag

Identificatore univoco locale ottenuto chiamando Funzione FwpsNetBufferListGetTagForContext0 . Questo è il tag di contesto usato nella chiamata iniziale a FwpsNetBufferListAssociateContext0.

[in] removeContext

Se impostato, FwpsNetBufferListRetrieveContext0 rimuoverà l'associazione di contesto oltre a recuperare il contesto.

[in] flags

Questo parametro è riservato per l'uso futuro e è impostato su zero.

[out] context

Contesto assegnato al pacchetto dal driver callout nella chiamata iniziale a FwpsNetBufferListAssociateContext0.

Valore restituito

La funzione FwpsNetBufferListRetrieveContext0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito Descrizione
STATUS_SUCCESS
L'associazione ha avuto successo.
Altri codici di stato
Si è verificato un errore.

Commenti

La funzione FwpsNetBufferListRetrieveContext0 recupera un elenco di buffer di rete contrassegnato in un altro livello.

È anche possibile usare questa funzione per rimuovere l'associazione di contesto impostando il parametro removeContext .

Requisiti

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

Vedi anche

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST