FreeCredentialsHandle 函式 (sspi.h)

  • 發行項

FreeCredentialsHandle 函式會通知安全性系統不再需要認證。 應用程式會在呼叫 DeleteSecurityContext 函式之後釋放呼叫 AcquireCredentialsHandle (General) 函式中取得的認證句柄，以釋放與認證相關聯的任何內容句柄。 拿掉此認證集的所有參考時，可以移除認證本身。

無法釋放認證句柄會導致記憶體流失。

語法

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle(
  [in] PCredHandle phCredential
);

參數

[in] phCredential

使用 AcquireCredentialsHandle (General) 函式取得之 CredHandle 句柄的指標。

傳回值

如果函式成功，函式會傳回SEC_E_OK。

如果函式失敗，它會傳回下列錯誤碼。

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

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 sspi.h (包含 Security.h)
程式庫 Secur32.lib
Dll Secur32.dll

另請參閱

AcquireCredentialsHandle (General)

SSPI 函式