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 è impostato il removeContext, l'elenco di buffer di rete restituito avrà rimosso il contesto.
[in] contextTag
Identificatore univoco locale ottenuto chiamando funzione di 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 uso futuro ed è 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 esito positivo. |
|
Si è verificato un errore. |
Osservazioni
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.
Fabbisogno
| 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 | <= DISPATCH_LEVEL |