FreeCredentialsHandle 関数 (sspi.h)

  • [アーティクル]

FreeCredentialsHandle 関数は、資格情報が不要になったことをセキュリティ システムに通知します。 アプリケーションは、この関数を呼び出して、DeleteSecurityContext 関数を呼び出した後に AcquireCredentialsHandle (General) 関数の呼び出しで取得した資格情報ハンドルを解放し、資格情報に関連付けられているコンテキスト ハンドルを解放します。 この資格情報セットへのすべての参照が削除されると、資格情報自体を削除できます。

資格情報ハンドルを解放しないと、メモリ リークが発生します。

構文

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

パラメーター

[in] phCredential

AcquireCredentialsHandle (General) 関数を使用して取得された CredHandle ハンドルへのポインター。

戻り値

関数が成功した場合、関数はSEC_E_OKを返します。

関数が失敗すると、次のエラー コードが返されます。

リターン コード 説明
SEC_E_INVALID_HANDLE
 関数に渡されたハンドルが無効です。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー sspi.h (Security.h を含む)
Library Secur32.lib
[DLL] Secur32.dll

こちらもご覧ください

AcquireCredentialsHandle (全般)

SSPI 関数