Win32 API 日本語リファレンス
ホーム › Security.Authentication.Identity › SpExportSecurityContextFn

SpExportSecurityContextFn

コールバック

シグネチャ

NTSTATUS SpExportSecurityContextFn(
    UINT_PTR phContext,
    DWORD fFlags,
    SecBuffer* pPackedContext,
    HANDLE* pToken
);

パラメーター

フィールド型説明
phContextUINT_PTRエクスポートするセキュリティコンテキストのハンドル。
fFlagsDWORD

省略可能。コンテキストの複製オプションを指定します。次の表に、Sspi.h で定義されている有効な値を示します。

値 意味
SECPKG_CONTEXT_EXPORT_RESET_NEW
新しいコンテキストは初期状態にリセットされます。
SECPKG_CONTEXT_EXPORT_DELETE_OLD
エクスポート時に古いコンテキストが削除されます。
pPackedContextSecBuffer*シリアル化されたコンテキストを格納する SecBuffer 構造体へのポインター。リソースは AllocateClientBuffer 関数を使用して割り当て、呼び出し元が FreeContextBuffer 関数を使用して解放する必要があります。
pTokenHANDLE*省略可能。コンテキストのトークンを受け取るハンドルへのポインター。

公式ドキュメント

セキュリティコンテキストを別のプロセスにエクスポートします。

SpExportSecurityContext 関数は、 Security Support Provider Interface の ExportSecurityContext 関数に対応するディスパッチ関数です。

戻り値

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

関数が失敗した場合は、失敗した理由を示す NTSTATUS コードを返します。

解説(Remarks)

以前にエクスポートしたセキュリティコンテキストをインポートするには、 SpImportSecurityContext 関数を使用します。

SSP/AP は SpExportSecurityContext 関数を実装する必要がありますが、実装に付ける実際の名前は開発者が自由に決められます。

SpExportSecurityContext 関数へのポインターは、 SpUserModeInitialize 関数から受け取る SECPKG_USER_FUNCTION_TABLE 構造体に格納されています。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)