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

こちらもご覧ください

AcceptSecurityContext (全般)

InitializeSecurityContext (全般)

SSPI 関数