Funzione FwpsNetBufferListRetrieveContext0 (fwpsk.h)
La funzione FwpsNetBufferListRetrieveContext0 recupera il contesto associato a un elenco di buffer di rete contrassegnato in un altro livello.
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 |
---|---|
|
L'associazione ha avuto successo. |
|
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 |