ホーム › System.PasswordManagement › MSChapSrvChangePassword2

MSChapSrvChangePassword2

関数

暗号化されたパスワードを用いてMS-CHAPでパスワードを変更する。

DLLADVAPI32.dll呼出規約winapi対応OSWindows XP 以降

シグネチャ

// ADVAPI32.dll
#include <windows.h>

DWORD MSChapSrvChangePassword2(
    LPWSTR ServerName,
    LPWSTR UserName,
    SAMPR_ENCRYPTED_USER_PASSWORD* NewPasswordEncryptedWithOldNt,
    ENCRYPTED_LM_OWF_PASSWORD* OldNtOwfPasswordEncryptedWithNewNt,
    BOOLEAN LmPresent,
    SAMPR_ENCRYPTED_USER_PASSWORD* NewPasswordEncryptedWithOldLm,
    ENCRYPTED_LM_OWF_PASSWORD* OldLmOwfPasswordEncryptedWithNewLmOrNt
);

パラメーター

名前	型	方向	説明
ServerName	LPWSTR	in	操作対象となるサーバーの汎用名前付け規則 (UNC) 名を指定する、null で終わる Unicode 文字列へのポインターです。このパラメーターが NULL の場合、関数はローカルコンピューター上で動作します。
UserName	LPWSTR	in	パスワードを変更するユーザーの名前を指定する、null で終わる Unicode 文字列へのポインターです。
NewPasswordEncryptedWithOldNt	SAMPR_ENCRYPTED_USER_PASSWORD*	in	現在の NT 一方向関数 (OWF) パスワードハッシュを暗号化キーとして使用して暗号化された、新しいクリアテキストのパスワードを格納する SAMPR_ENCRYPTED_USER_PASSWORD 構造体へのポインターです。注意 NewPasswordEncryptedWithOldNt の暗号文を計算するには、RFC 2433 のセクション A.11 で定義されている NewPasswordEncryptedWithOldNtPasswordHash() 関数を使用してください。
OldNtOwfPasswordEncryptedWithNewNt	ENCRYPTED_LM_OWF_PASSWORD*	in	新しい NT OWF パスワードハッシュを暗号化キーとして使用して暗号化された、古い NT OWF パスワードハッシュを格納する ENCRYPTED_NT_OWF_PASSWORD 構造体へのポインターです。
LmPresent	BOOLEAN	in	NewPasswordEncryptedWithOldNt および OldNtOwfPasswordEncryptedWithNewNt の暗号文を生成する際の暗号化キーとして、現在の Lan Manager (LM) と NT のどちらの OWF パスワードハッシュを使用するかを指定する BOOLEAN です。TRUE の場合、NT OWF パスワードハッシュではなく LM OWF パスワードハッシュが使用されます。
NewPasswordEncryptedWithOldLm	SAMPR_ENCRYPTED_USER_PASSWORD*	in	現在の LM OWF パスワードハッシュを使用して暗号化された、新しいクリアテキストのパスワードを格納する SAMPR_ENCRYPTED_USER_PASSWORD 構造体へのポインターです。注意 NewPasswordEncryptedWithOldLm の暗号文を計算するには、RFC 2433 のセクション A.15 で定義されている NewPasswordEncryptedWithOldLmPasswordHash() 関数を使用してください。
OldLmOwfPasswordEncryptedWithNewLmOrNt	ENCRYPTED_LM_OWF_PASSWORD*	in	新しい LM OWF パスワードハッシュを使用して暗号化された、現在の LM OWF パスワードハッシュを格納する ENCRYPTED_LM_OWF_PASSWORD 構造体へのポインターです。

戻り値の型: DWORD

公式ドキュメント

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

戻り値

関数が成功した場合、戻り値は STATUS_SUCCESS (0x00000000) です。

関数が失敗した場合、戻り値は ntstatus.h に定義された次のいずれかのエラーコードです。

リターンコード/値	説明
STATUS_ACCESS_DENIED 0xC0000022	呼び出し元のアプリケーションに、この操作を完了するための適切な特権がありません。
STATUS_INVALID_HANDLE 0xC0000008	指定されたサーバー名またはユーザー名が有効ではありませんでした。
STATUS_ILL_FORMED_PASSWORD 0xC000006B	新しいパスワードの形式が正しくありません。たとえば、キーボードから入力できない文字が含まれています。
STATUS_PASSWORD_RESTRICTION 0xC000006C	制限によりパスワードを変更できません。考えられる制限には、パスワードの変更頻度に関する時間的な制限や、指定されたパスワードの長さに関する制限などがあります。新しいパスワードが、そのアカウントの最近使用したパスワードの履歴ログ内のパスワードと一致した場合にも、このエラーが返されます。セキュリティ管理者は、最近使用されたパスワードのうち何個を再利用できないようにするかを指定します。それらはパスワードの履歴ログに保持されます。
STATUS_WRONG_PASSWORD 0xC000006A	古いパスワードのパラメーターが、ユーザーの現在のパスワードと一致しません。
STATUS_INVALID_DOMAIN_STATE 0xC00000DD	ドメインコントローラーが有効な状態ではありません。この操作を行うには、ドメインコントローラーが有効になっている必要があります。
STATUS_INVALID_DOMAIN_ROLE 0xC00000DE	ドメインコントローラーが、要求された操作を実行するには適切でない役割で動作しています。この操作はプライマリドメインコントローラーでのみ実行できます。

解説(Remarks)

この関数でユーザーが自分自身のパスワードを変更できるのは、USER_CHANGE_PASSWORD のアクセス権を持っている場合のみです。

パスワードの変更が管理上のパスワード制限と競合する場合、この関数は STATUS_PASSWORD_RESTRICTION で失敗します。

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

各言語での呼び出し定義

// ADVAPI32.dll
#include <windows.h>

DWORD MSChapSrvChangePassword2(
    LPWSTR ServerName,
    LPWSTR UserName,
    SAMPR_ENCRYPTED_USER_PASSWORD* NewPasswordEncryptedWithOldNt,
    ENCRYPTED_LM_OWF_PASSWORD* OldNtOwfPasswordEncryptedWithNewNt,
    BOOLEAN LmPresent,
    SAMPR_ENCRYPTED_USER_PASSWORD* NewPasswordEncryptedWithOldLm,
    ENCRYPTED_LM_OWF_PASSWORD* OldLmOwfPasswordEncryptedWithNewLmOrNt
);

[DllImport("ADVAPI32.dll", ExactSpelling = true)]
static extern uint MSChapSrvChangePassword2(
    [MarshalAs(UnmanagedType.LPWStr)] string ServerName,   // LPWSTR
    [MarshalAs(UnmanagedType.LPWStr)] string UserName,   // LPWSTR
    IntPtr NewPasswordEncryptedWithOldNt,   // SAMPR_ENCRYPTED_USER_PASSWORD*
    IntPtr OldNtOwfPasswordEncryptedWithNewNt,   // ENCRYPTED_LM_OWF_PASSWORD*
    [MarshalAs(UnmanagedType.U1)] bool LmPresent,   // BOOLEAN
    IntPtr NewPasswordEncryptedWithOldLm,   // SAMPR_ENCRYPTED_USER_PASSWORD*
    IntPtr OldLmOwfPasswordEncryptedWithNewLmOrNt   // ENCRYPTED_LM_OWF_PASSWORD*
);

<DllImport("ADVAPI32.dll", ExactSpelling:=True)>
Public Shared Function MSChapSrvChangePassword2(
    <MarshalAs(UnmanagedType.LPWStr)> ServerName As String,   ' LPWSTR
    <MarshalAs(UnmanagedType.LPWStr)> UserName As String,   ' LPWSTR
    NewPasswordEncryptedWithOldNt As IntPtr,   ' SAMPR_ENCRYPTED_USER_PASSWORD*
    OldNtOwfPasswordEncryptedWithNewNt As IntPtr,   ' ENCRYPTED_LM_OWF_PASSWORD*
    <MarshalAs(UnmanagedType.U1)> LmPresent As Boolean,   ' BOOLEAN
    NewPasswordEncryptedWithOldLm As IntPtr,   ' SAMPR_ENCRYPTED_USER_PASSWORD*
    OldLmOwfPasswordEncryptedWithNewLmOrNt As IntPtr   ' ENCRYPTED_LM_OWF_PASSWORD*
) As UInteger
End Function

' ServerName : LPWSTR
' UserName : LPWSTR
' NewPasswordEncryptedWithOldNt : SAMPR_ENCRYPTED_USER_PASSWORD*
' OldNtOwfPasswordEncryptedWithNewNt : ENCRYPTED_LM_OWF_PASSWORD*
' LmPresent : BOOLEAN
' NewPasswordEncryptedWithOldLm : SAMPR_ENCRYPTED_USER_PASSWORD*
' OldLmOwfPasswordEncryptedWithNewLmOrNt : ENCRYPTED_LM_OWF_PASSWORD*
Declare PtrSafe Function MSChapSrvChangePassword2 Lib "advapi32" ( _
    ByVal ServerName As LongPtr, _
    ByVal UserName As LongPtr, _
    ByVal NewPasswordEncryptedWithOldNt As LongPtr, _
    ByVal OldNtOwfPasswordEncryptedWithNewNt As LongPtr, _
    ByVal LmPresent As Byte, _
    ByVal NewPasswordEncryptedWithOldLm As LongPtr, _
    ByVal OldLmOwfPasswordEncryptedWithNewLmOrNt As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

MSChapSrvChangePassword2 = ctypes.windll.advapi32.MSChapSrvChangePassword2
MSChapSrvChangePassword2.restype = wintypes.DWORD
MSChapSrvChangePassword2.argtypes = [
    wintypes.LPCWSTR,  # ServerName : LPWSTR
    wintypes.LPCWSTR,  # UserName : LPWSTR
    ctypes.c_void_p,  # NewPasswordEncryptedWithOldNt : SAMPR_ENCRYPTED_USER_PASSWORD*
    ctypes.c_void_p,  # OldNtOwfPasswordEncryptedWithNewNt : ENCRYPTED_LM_OWF_PASSWORD*
    wintypes.BOOLEAN,  # LmPresent : BOOLEAN
    ctypes.c_void_p,  # NewPasswordEncryptedWithOldLm : SAMPR_ENCRYPTED_USER_PASSWORD*
    ctypes.c_void_p,  # OldLmOwfPasswordEncryptedWithNewLmOrNt : ENCRYPTED_LM_OWF_PASSWORD*
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ADVAPI32.dll')
MSChapSrvChangePassword2 = Fiddle::Function.new(
  lib['MSChapSrvChangePassword2'],
  [
    Fiddle::TYPE_VOIDP,  # ServerName : LPWSTR
    Fiddle::TYPE_VOIDP,  # UserName : LPWSTR
    Fiddle::TYPE_VOIDP,  # NewPasswordEncryptedWithOldNt : SAMPR_ENCRYPTED_USER_PASSWORD*
    Fiddle::TYPE_VOIDP,  # OldNtOwfPasswordEncryptedWithNewNt : ENCRYPTED_LM_OWF_PASSWORD*
    Fiddle::TYPE_CHAR,  # LmPresent : BOOLEAN
    Fiddle::TYPE_VOIDP,  # NewPasswordEncryptedWithOldLm : SAMPR_ENCRYPTED_USER_PASSWORD*
    Fiddle::TYPE_VOIDP,  # OldLmOwfPasswordEncryptedWithNewLmOrNt : ENCRYPTED_LM_OWF_PASSWORD*
  ],
  -Fiddle::TYPE_INT)

#[link(name = "advapi32")]
extern "system" {
    fn MSChapSrvChangePassword2(
        ServerName: *mut u16,  // LPWSTR
        UserName: *mut u16,  // LPWSTR
        NewPasswordEncryptedWithOldNt: *mut SAMPR_ENCRYPTED_USER_PASSWORD,  // SAMPR_ENCRYPTED_USER_PASSWORD*
        OldNtOwfPasswordEncryptedWithNewNt: *mut ENCRYPTED_LM_OWF_PASSWORD,  // ENCRYPTED_LM_OWF_PASSWORD*
        LmPresent: u8,  // BOOLEAN
        NewPasswordEncryptedWithOldLm: *mut SAMPR_ENCRYPTED_USER_PASSWORD,  // SAMPR_ENCRYPTED_USER_PASSWORD*
        OldLmOwfPasswordEncryptedWithNewLmOrNt: *mut ENCRYPTED_LM_OWF_PASSWORD  // ENCRYPTED_LM_OWF_PASSWORD*
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("ADVAPI32.dll")]
public static extern uint MSChapSrvChangePassword2([MarshalAs(UnmanagedType.LPWStr)] string ServerName, [MarshalAs(UnmanagedType.LPWStr)] string UserName, IntPtr NewPasswordEncryptedWithOldNt, IntPtr OldNtOwfPasswordEncryptedWithNewNt, [MarshalAs(UnmanagedType.U1)] bool LmPresent, IntPtr NewPasswordEncryptedWithOldLm, IntPtr OldLmOwfPasswordEncryptedWithNewLmOrNt);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ADVAPI32_MSChapSrvChangePassword2' -Namespace Win32 -PassThru
# $api::MSChapSrvChangePassword2(ServerName, UserName, NewPasswordEncryptedWithOldNt, OldNtOwfPasswordEncryptedWithNewNt, LmPresent, NewPasswordEncryptedWithOldLm, OldLmOwfPasswordEncryptedWithNewLmOrNt)

#uselib "ADVAPI32.dll"
#func global MSChapSrvChangePassword2 "MSChapSrvChangePassword2" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; MSChapSrvChangePassword2 ServerName, UserName, varptr(NewPasswordEncryptedWithOldNt), varptr(OldNtOwfPasswordEncryptedWithNewNt), LmPresent, varptr(NewPasswordEncryptedWithOldLm), varptr(OldLmOwfPasswordEncryptedWithNewLmOrNt)   ; 戻り値は stat
; ServerName : LPWSTR -> "sptr"
; UserName : LPWSTR -> "sptr"
; NewPasswordEncryptedWithOldNt : SAMPR_ENCRYPTED_USER_PASSWORD* -> "sptr"
; OldNtOwfPasswordEncryptedWithNewNt : ENCRYPTED_LM_OWF_PASSWORD* -> "sptr"
; LmPresent : BOOLEAN -> "sptr"
; NewPasswordEncryptedWithOldLm : SAMPR_ENCRYPTED_USER_PASSWORD* -> "sptr"
; OldLmOwfPasswordEncryptedWithNewLmOrNt : ENCRYPTED_LM_OWF_PASSWORD* -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "ADVAPI32.dll"
#cfunc global MSChapSrvChangePassword2 "MSChapSrvChangePassword2" wstr, wstr, var, var, int, var, var
; res = MSChapSrvChangePassword2(ServerName, UserName, NewPasswordEncryptedWithOldNt, OldNtOwfPasswordEncryptedWithNewNt, LmPresent, NewPasswordEncryptedWithOldLm, OldLmOwfPasswordEncryptedWithNewLmOrNt)
; ServerName : LPWSTR -> "wstr"
; UserName : LPWSTR -> "wstr"
; NewPasswordEncryptedWithOldNt : SAMPR_ENCRYPTED_USER_PASSWORD* -> "var"
; OldNtOwfPasswordEncryptedWithNewNt : ENCRYPTED_LM_OWF_PASSWORD* -> "var"
; LmPresent : BOOLEAN -> "int"
; NewPasswordEncryptedWithOldLm : SAMPR_ENCRYPTED_USER_PASSWORD* -> "var"
; OldLmOwfPasswordEncryptedWithNewLmOrNt : ENCRYPTED_LM_OWF_PASSWORD* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "ADVAPI32.dll"
#cfunc global MSChapSrvChangePassword2 "MSChapSrvChangePassword2" wstr, wstr, sptr, sptr, int, sptr, sptr
; res = MSChapSrvChangePassword2(ServerName, UserName, varptr(NewPasswordEncryptedWithOldNt), varptr(OldNtOwfPasswordEncryptedWithNewNt), LmPresent, varptr(NewPasswordEncryptedWithOldLm), varptr(OldLmOwfPasswordEncryptedWithNewLmOrNt))
; ServerName : LPWSTR -> "wstr"
; UserName : LPWSTR -> "wstr"
; NewPasswordEncryptedWithOldNt : SAMPR_ENCRYPTED_USER_PASSWORD* -> "sptr"
; OldNtOwfPasswordEncryptedWithNewNt : ENCRYPTED_LM_OWF_PASSWORD* -> "sptr"
; LmPresent : BOOLEAN -> "int"
; NewPasswordEncryptedWithOldLm : SAMPR_ENCRYPTED_USER_PASSWORD* -> "sptr"
; OldLmOwfPasswordEncryptedWithNewLmOrNt : ENCRYPTED_LM_OWF_PASSWORD* -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。