PSAM_PASSWORD_NOTIFICATION_ROUTINE コールバック関数 (ntsecapi.h)

  • [アーティクル]

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

構文

PSAM_PASSWORD_NOTIFICATION_ROUTINE PsamPasswordNotificationRoutine;

NTSTATUS PsamPasswordNotificationRoutine(
  [in] PUNICODE_STRING UserName,
  [in] ULONG RelativeId,
  [in] PUNICODE_STRING NewPassword
)
{...}

パラメーター

[in] UserName

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

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

[in] RelativeId

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

[in] NewPassword

UserName で指定されたユーザーの新しいプレーンテキスト パスワード。 パスワードの使用が完了したら、 SecureZeroMemory 関数を呼び出して情報をクリアします。 パスワードの保護の詳細については、「パスワードの 処理」を参照してください。

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

戻り値

リターン コード 説明
STATUS_SUCCESS
 ユーザーのパスワードが変更されたか、 UserName パラメーターと NewPassword パラメーターの両方の値が NULL であることを示します。

注釈

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

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

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

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

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

対象 解決方法については、
パスワード フィルター DLL を実装するときのプログラミングの問題 パスワード フィルターのプログラミングに関する考慮事項
独自のパスワード フィルター DLL をインストールして登録する方法 パスワード フィルター DLL のインストールと登録
Microsoft によって提供されるパスワード フィルター DLL 強力なパスワードの適用と Passfilt.dll

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntsecapi.h

こちらもご覧ください

InitializeChangeNotify

PasswordFilter