ExportSecurityContext 関数 (sspi.h)

ExportSecurityContext 関数は、後で を呼び出すことによって別のプロセスにインポートできるセキュリティ コンテキストのシリアル化された表現を作成します
ImportSecurityContext。 セキュリティ コンテキストをインポートするプロセスは、 ExportSecurityContext を呼び出したプロセスと同じコンピューターで実行されている必要があります。

構文

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ExportSecurityContext(
  [in]            PCtxtHandle phContext,
  [in]            ULONG       fFlags,
  [out]           PSecBuffer  pPackedContext,
  [out, optional] void        **pToken
);

パラメーター

[in] phContext

エクスポートするセキュリティ コンテキストのハンドル。

[in] fFlags

このパラメーターには、次の値のビットごとの OR の組み合わせを指定できます。

値	意味
SECPKG_CONTEXT_EXPORT_RESET_NEW 1 (0x1)	新しいセキュリティ コンテキストは初期状態にリセットされます。
SECPKG_CONTEXT_EXPORT_DELETE_OLD 2 (0x2)	古いセキュリティ コンテキストが削除されます。
SECPKG_CONTEXT_EXPORT_TO_KERNEL 4 (0x4)	この値はサポートされていません。 Windows Server 2003 および Windows XP/2000: セキュリティ コンテキストはカーネルにエクスポートされます。この値は、Schannel カーネル モードでのみサポートされます。

[out] pPackedContext

シリアル化されたセキュリティ コンテキストを受け取るSECBUFFER_EMPTY型のバッファーへのポインター。 このコンテキストの使用が完了したら、 FreeContextBuffer 関数を呼び出して解放します。

[out, optional] pToken

コンテキストのトークンのハンドルを受け取るポインター。

ユーザー トークンの使用が完了したら、 CloseHandle 関数を呼び出してハンドルを解放します。

戻り値

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

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

リターン コード	説明
SEC_E_INSUFFICIENT_MEMORY	要求されたアクションを完了するのに十分なメモリがありません。
SEC_E_INVALID_HANDLE	phContext パラメーターは、有効なハンドルを指していません。
SEC_E_NOT_SUPPORTED	Schannel カーネル モードでは、この関数はサポートされていません。

要件

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

こちらもご覧ください

FreeContextBuffer

ImportSecurityContext

SSPI 関数