deleteSecurityContext 函式 (sspi.h)

DeleteSecurityContext 函式會刪除先前呼叫 InitializeSecurityContext (General) 函式或 AcceptSecurityContext (General) 函式所起始之指定安全性內容相關聯的本機數據結構。

語法

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY DeleteSecurityContext(
  [in] PCtxtHandle phContext
);

[in] phContext

要刪除的安全性內容句柄。

警告

請勿在 DeleteSecurityContext 的並行呼叫中使用相同的內容句柄。安全性服務提供者中的 API 實作不是安全線程。

如果函式成功或已經刪除句柄，則會 SEC_E_OK傳回值。

如果函式失敗，傳回值可以是下列錯誤碼：

傳回碼	Description
SEC_E_INVALID_HANDLE	傳遞至函式的句柄無效。

DeleteSecurityContext 函式會終止安全性內容，並釋放相關聯的資源。

當不再需要安全性內容時，呼叫端必須針對安全性內容呼叫此函式。如果安全性內容為部分、不完整、已拒絕或失敗，則為 true。成功刪除安全性內容之後，不允許進一步使用該安全性內容，而且句柄不再有效。