MSChapSrvChangePassword2

MSChapSrvChangePassword2 関数は、相互暗号化をサポートしながらユーザーアカウントのパスワードを変更する。

MSChapSrvChangePassword2 ServerName, UserName, NewPasswordEncryptedWithOldNt, OldNtOwfPasswordEncryptedWithNewNt, LmPresent, NewPasswordEncryptedWithOldLm, OldLmOwfPasswordEncryptedWithNewLmOrNt

ServerName : [wstr] 操作対象のサーバーの汎用名前付け規則 (UNC) 名を指定する null 終端 Unicode 文字列へのポインタ。このパラメータが NULL の場合、関数はローカルコンピュータで動作する。
UserName : [wstr] パスワードを変更するユーザーの名前を指定する null 終端 Unicode 文字列へのポインタ。
NewPasswordEncryptedWithOldNt : [var] 現在の NT 一方向関数 (OWF) パスワードハッシュを暗号化キーとして使用して暗号化された新しい平文パスワードを含む SAMPR_ENCRYPTED_USER_PASSWORD 構造体へのポインタ。注: NewPasswordEncryptedWithOldNt の暗号を計算するには、RFC 2433 section A.11 で定義されている NewPasswordEncryptedWithOldNtPasswordHash() 関数を使用する。
OldNtOwfPasswordEncryptedWithNewNt : [var] 新しい NT OWF パスワードハッシュを暗号化キーとして使用して暗号化された古い NT OWF パスワードハッシュを含む ENCRYPTED_NT_OWF_PASSWORD 構造体へのポインタ。
LmPresent : [int] 現在の Lan Manager (LM) または NT OWF パスワードハッシュを、NewPasswordEncryptedWithOldNt および OldNtOwfPasswordEncryptedWithNewNt 暗号を生成する際の暗号化キーとして使用するかどうかを指定する BOOLEAN。TRUE の場合、NT OWF パスワードハッシュではなく LM OWF パスワードハッシュが使用される。
NewPasswordEncryptedWithOldLm : [var] 現在の LM OWF パスワードハッシュを使用して暗号化された新しい平文パスワードを含む SAMPR_ENCRYPTED_USER_PASSWORD 構造体へのポインタ。注: NewPasswordEncryptedWithOldLm の暗号を計算するには、RFC 2433 section A.15 で定義されている NewPasswordEncryptedWithOldLmPasswordHash() 関数を使用する。
OldLmOwfPasswordEncryptedWithNewLmOrNt : [var] 新しい LM OWF パスワードハッシュを使用して暗号化された現在の LM OWF パスワードハッシュを含む ENCRYPTED_LM_OWF_PASSWORD 構造体へのポインタ。

(プラグイン / モジュール : advapi32.dll)

解説

MSChapSrvChangePassword2 関数は、相互暗号化をサポートしながらユーザーアカウントのパスワードを変更する。

[戻り値]
関数が成功した場合、戻り値は STATUS_SUCCESS (0x00000000) である。関数が失敗した場合、戻り値は
ntstatus.h の以下のエラーコードのいずれかである。
（以下省略）

[備考]
この関数は、USER_CHANGE_PASSWORD
アクセスを持つ場合にのみユーザー自身のパスワードを変更できる。パスワード変更の試みが管理パスワード制限と競合する場合、この関数は
STATUS_PASSWORD_RESTRICTION で失敗する。

情報