DeleteSecurityContext 関数 (sspi.h)
DeleteSecurityContext 関数は、InitializeSecurityContext(General) 関数または AcceptSecurityContext (General) 関数の以前の呼び出しによって開始された、指定されたセキュリティ コンテキストに関連付けられているローカル データ構造を削除します。
構文
KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY DeleteSecurityContext(
[in] PCtxtHandle phContext
);
パラメーター
[in] phContext
削除するセキュリティ コンテキストのハンドル。
警告
DeleteSecurityContext の同時呼び出しでは、同じコンテキスト ハンドルを使用しないでください。 セキュリティ サービス プロバイダーの API 実装はスレッド セーフではありません。
戻り値
関数が成功した場合、またはハンドルが既に削除されている場合、戻り値は SEC_E_OK。
関数が失敗した場合、戻り値は次のエラー コードになります。
| リターン コード | 説明 |
|---|---|
| SEC_E_INVALID_HANDLE | 関数に渡されたハンドルが無効です。 |
注釈
DeleteSecurityContext 関数は、セキュリティ コンテキストを終了し、関連付けられているリソースを解放します。
セキュリティ コンテキストが不要になった場合、呼び出し元はセキュリティ コンテキストに対してこの関数を呼び出す必要があります。 これは、セキュリティ コンテキストが部分的、不完全、拒否、または失敗した場合に当てはまります。 セキュリティ コンテキストが正常に削除されると、そのセキュリティ コンテキストをさらに使用することは許可されず、ハンドルは無効になります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | sspi.h (Security.h を含む) |
| Library | Secur32.lib |
| [DLL] | Secur32.dll |