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

PSAM_PASSWORD_NOTIFICATION_ROUTINE

コールバック

シグネチャ

NTSTATUS PSAM_PASSWORD_NOTIFICATION_ROUTINE(
    LSA_UNICODE_STRING* UserName,
    DWORD RelativeId,
    LSA_UNICODE_STRING* NewPassword
);

パラメーター

フィールド型説明
UserNameLSA_UNICODE_STRING*

パスワードが変更されたユーザーのアカウント名。

このパラメーターと NewPassword パラメーターの値がどちらも NULL の場合、この関数は STATUS_SUCCESS を返す必要があります。

RelativeIdDWORDUserName で指定されたユーザーの相対識別子 (RID)。
NewPasswordLSA_UNICODE_STRING*

UserName で指定されたユーザーの新しいプレーンテキストのパスワード。パスワードの使用が終わったら、SecureZeroMemory 関数を呼び出して情報を消去してください。パスワードの保護の詳細については、Handling Passwords を参照してください。

このパラメーターと UserName パラメーターの値がどちらも NULL の場合、この関数は STATUS_SUCCESS を返す必要があります。

公式ドキュメント

PasswordChangeNotify 関数は、パスワードフィルター DLL によって実装されます。この関数は、パスワードが変更されたことを DLL に通知します。

戻り値

戻り値 説明
STATUS_SUCCESS
 ユーザーのパスワードが変更されたこと、または UserName パラメーターと NewPassword パラメーターの値がどちらも NULL であることを示します。

解説(Remarks)

PasswordChangeNotify 関数は、PasswordFilter 関数が正常に呼び出され、新しいパスワードが保存された後に呼び出されます。

この関数は __stdcall 呼び出し規約を使用し、DLL からエクスポートされる必要があります。

PasswordChangeNotify ルーチンの実行中は、ルーチンが完了するまで処理がブロックされます。必要に応じて、時間のかかる処理は、このルーチンから戻る前に別のスレッドへ移してください。

この関数は、システムにインストールされ登録されたパスワードフィルターに対してのみ呼び出されます。

この関数内で処理されないプロセス例外は、システム全体にわたるセキュリティ関連の障害を引き起こす可能性があります。必要に応じて構造化例外処理を使用してください。

情報の種類 参照先
パスワードフィルター DLL を実装する際のプログラミング上の考慮事項 Password Filter Programming Considerations
独自のパスワードフィルター DLL をインストールして登録する方法 Installing and Registering a Password Filter DLL
Microsoft が提供するパスワードフィルター DLL Strong Password Enforcement and Passfilt.dll
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)