SspiDeleteSecurityContextAsync 函式 (sspi.h)
SspiDeleteSecurityContextAsync 函式會刪除與先前呼叫 SspiInitializeSecurityContextAsync 函式或 SspiAcceptSecurityContextAsync 函式所起始之指定安全性內容相關聯的本機數據結構。
語法
SECURITY_STATUS SspiDeleteSecurityContextAsync(
SspiAsyncContext *AsyncContext,
PCtxtHandle phContext
);
參數
AsyncContext
異步呼叫內容。
phContext
要刪除的安全性內容句柄。
傳回值
如果刪除安全性內容的異步要求已成功排入佇列以供執行，則傳回 SEC_E_OK 。 否則，它會傳回嘗試將錯誤排入佇列時所產生的錯誤。 若要擷取作業的狀態，請使用 SspiGetAsyncCallStatus。
SspiGetAsyncCallStatus 會在完成時 傳回SEC_E_OK 。 否則，如果呼叫仍在進行中，或下列其中一個錯誤碼，它可能會傳回 SEC_I_ASYNC_CALL_PENDING 。
傳回碼 |
Description |
|---|---|
| SEC_E_INVALID_HANDLE | 傳遞至函式的句柄無效。 |
備註
在異步呼叫完成時，呼叫端可以退出退出接收通知，方法是避免為新的 SspiAsyncContext 設定回呼，或使用 SspiSetAsyncNotifyCallback 搭配 Null 參數移除回呼。 如果退出退出，則呼叫端應該在呼叫 SspiDeleteSecurityContextAsync 之後立即釋放 具有 SspiFreeAsync 的內容，除非內容是要重複使用。
SspiDeleteSecurityContextAsync 函式會終止安全性內容，並釋放相關聯的資源。
當不再需要安全性內容時，呼叫端必須針對安全性內容呼叫此函式。 如果安全性內容為部分、不完整、已拒絕或失敗，則為 true。 成功刪除安全性內容之後，不允許進一步使用該安全性內容，而且句柄不再有效。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 1607 [僅限內核模式驅動程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限內核模式驅動程式] |
| 標頭 | sspi.h |
另請參閱
SspiAcceptSecurityContextAsync