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

SpUserModeInitializeFn

コールバック

シグネチャ

NTSTATUS SpUserModeInitializeFn(
    DWORD LsaVersion,
    DWORD* PackageVersion,
    SECPKG_USER_FUNCTION_TABLE** ppTables,
    DWORD* pcTables
);

パラメーター

フィールド型説明
LsaVersionDWORDセキュリティプロバイダー DLL (Secur32.dll または Security.dll) のバージョンです。
PackageVersionDWORD*SSP/AP DLL のバージョンを返すポインターです。
ppTablesSECPKG_USER_FUNCTION_TABLE**SECPKG_USER_FUNCTION_TABLE 構造体の配列を返すポインターです。各構造体は、SSP/AP DLL に配置されたセキュリティパッケージが実装するユーザーモード関数へのポインターのテーブルです。
pcTablesDWORD*ppTables パラメーターが指す配列の要素数を返すポインターです。

公式ドキュメント

SpUserModeInitialize 関数は、セキュリティサポートプロバイダー/認証パッケージ (SSP/AP) DLL が、クライアント/サーバーアプリケーションのプロセス空間に読み込まれたときに呼び出されます。この関数は、SSP/AP DLL 内の各セキュリティパッケージに対応する SECPKG_USER_FUNCTION_TABLE テーブルを提供します。

戻り値

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

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

解説(Remarks)

SpUserModeInitialize 関数は、ユーザーモードのセキュリティパッケージを含む SSP/AP DLL で実装する必要があります。

ppTables パラメーターには、DLL に配置されたユーザーモードのセキュリティパッケージごとに 1 つの SECPKG_USER_FUNCTION_TABLE を格納します。DLL へのセキュリティパッケージの配置について詳しくは、 ユーザーモードの初期化を参照してください。

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