共用方式為


FwpsQueryPacketInjectionState0 函式 (fwpsk.h)

FwpsQueryPacketInjectionState0 函式是由圖說文字呼叫,以查詢封包數據的插入狀態。

注意FwpsQueryPacketInjectionState0 是特定版本的 FwpsQueryPacketInjectionState。 如需詳細資訊 ,請參閱 Version-Independent 名稱和以特定 Windows 版本為目標
 

語法

FWPS_PACKET_INJECTION_STATE FwpsQueryPacketInjectionState0(
  [in]            HANDLE                injectionHandle,
  [in]            const NET_BUFFER_LIST *netBufferList,
  [out, optional] HANDLE                *injectionContext
);

參數

[in] injectionHandle

先前由呼叫 所建立的插入句柄 FwpsInjectionHandleCreate0 函式。

[in] netBufferList

描述所分類封包數據的 NET_BUFFER_LIST 結構的指標。 封包可以來自網路堆疊,或者它可由一個的一個圖說文字驅動程式插入網路堆疊中。

[out, optional] injectionContext

插入內容的選擇性句柄。 如果指定指標,而且如果與插入句柄相關聯的封包插入狀態 FWPS_PACKET_INJECTION_STATE FWPS_PACKET_INJECTED_BY_SELF或FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF,則會傳回插入封包時所提供的插入內容。

傳回值

FwpsQueryPacketInjectionState0 函式會傳回FWPS_PACKET_INJECTION_STATE列舉的其中一個常數值。

備註

因為插入的封包數據可以針對插入的圖說文字重新分類,所以此函式允許圖說文字在必要時檢查封包數據的插入歷程記錄,藉此避免重複檢查已檢查的封包數據。

圖說文字可以在封包數據插入時指定其中一個封包插入函式中的選擇性 injectionContext 句柄,來追蹤其他註標特定資訊。 如果 FwpsQueryPacketInjectionState0 函式傳回 FWPS_PACKET_INJECTED_BY_SELFFWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF,則提供的 injectionContext 會當做執行插入之函式的 completionContext 參數傳回。

如果傳回值是FWPS_PACKET_INJECTED_BY_SELFFWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF,netBufferList 所指向的網路緩衝區清單就不應該進一步修改或畫筆作為複製和插入程式的一部分。 在此情況下,圖說文字應該將 classifyFn 函式之 classifyOut 參數所指向之 FWPS_CLASSIFY_OUT0 結構的 actionType 成員設定為 FWP_ACTION_CONTINUEFWP_ACTION_PERMIT。 這可讓封包繼續下一個註標。

規格需求

需求
最低支援的用戶端 從 Windows Vista 開始提供。
目標平台 Universal
標頭 fwpsk.h (包含 Fwpsk.h)
程式庫 Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

另請參閱

FWPS_CLASSIFY_OUT0

FWPS_PACKET_INJECTION_STATE

FwpsInjectionHandleCreate0

NET_BUFFER_LIST

classifyFn