IPsecSaContextExpire0 函式 (fwpmk.h)
IPsecSaContextExpire0 函式表示 IPsec 安全性關聯 (SA) 內容應該過期。
語法
NTSTATUS IPsecSaContextExpire0(
[in] HANDLE engineHandle,
[in] UINT64 id
);
參數
[in] engineHandle
處理篩選引擎開啟的會話。 呼叫 FwpmEngineOpen0,以開啟篩選引擎的會話。
[in] id
SA 內容的運行時間識別碼。 當應用程式呼叫 IPsecSaContextCreate0時,系統會收到此標識符。
傳回值
傳回碼/值 | 描述 |
---|---|
ERROR_SUCCESS 0 |
IPsec SA 內容已成功過期。 |
FWP_E_* 錯誤碼 0x80320001— 0x80320039 |
Windows 篩選平臺 (WFP) 特定錯誤。 如需詳細資訊,請參閱 WFP 錯誤碼。 |
RPC_* 錯誤碼 0x80010001— 0x80010122 |
無法與遠端或本機防火牆引擎通訊。 |
其他 NTSTATUS 代碼 | 發生錯誤。 |
言論
當 SA 內容過期時,對應的輸出 SA 會立即刪除,而輸入 SA 刪除則會延遲一分鐘。 這允許處理任何可能仍在線路上的輸入 IPsec 受保護流量。
呼叫端需要 DELETE IPsec 安全性關聯資料庫的存取權。 如需詳細資訊,請參閱 訪問控制。
IPsecSaContextExpire0 是 IPsecSaContextExpire 的特定實作。 如需詳細資訊,請參閱 糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows Vista 開始提供。 |
目標平臺 | 普遍 |
標頭 | fwpmk.h |
連結庫 | fwpkclnt.lib |
IRQL | <= PASSIVE_LEVEL |