ホーム › System.PasswordManagement › MSChapSrvChangePassword

MSChapSrvChangePassword

関数

MS-CHAPでユーザーのOWFパスワードを変更する。

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

シグネチャ

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

DWORD MSChapSrvChangePassword(
    LPWSTR ServerName,
    LPWSTR UserName,
    BOOLEAN LmOldPresent,
    LM_OWF_PASSWORD* LmOldOwfPassword,
    LM_OWF_PASSWORD* LmNewOwfPassword,
    LM_OWF_PASSWORD* NtOldOwfPassword,
    LM_OWF_PASSWORD* NtNewOwfPassword
);

パラメーター

名前	型	方向
ServerName	LPWSTR	in
UserName	LPWSTR	in
LmOldPresent	BOOLEAN	in
LmOldOwfPassword	LM_OWF_PASSWORD*	in
LmNewOwfPassword	LM_OWF_PASSWORD*	in
NtOldOwfPassword	LM_OWF_PASSWORD*	in
NtNewOwfPassword	LM_OWF_PASSWORD*	in

戻り値の型: DWORD

各言語での呼び出し定義

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

DWORD MSChapSrvChangePassword(
    LPWSTR ServerName,
    LPWSTR UserName,
    BOOLEAN LmOldPresent,
    LM_OWF_PASSWORD* LmOldOwfPassword,
    LM_OWF_PASSWORD* LmNewOwfPassword,
    LM_OWF_PASSWORD* NtOldOwfPassword,
    LM_OWF_PASSWORD* NtNewOwfPassword
);

[DllImport("ADVAPI32.dll", ExactSpelling = true)]
static extern uint MSChapSrvChangePassword(
    [MarshalAs(UnmanagedType.LPWStr)] string ServerName,   // LPWSTR
    [MarshalAs(UnmanagedType.LPWStr)] string UserName,   // LPWSTR
    [MarshalAs(UnmanagedType.U1)] bool LmOldPresent,   // BOOLEAN
    IntPtr LmOldOwfPassword,   // LM_OWF_PASSWORD*
    IntPtr LmNewOwfPassword,   // LM_OWF_PASSWORD*
    IntPtr NtOldOwfPassword,   // LM_OWF_PASSWORD*
    IntPtr NtNewOwfPassword   // LM_OWF_PASSWORD*
);

<DllImport("ADVAPI32.dll", ExactSpelling:=True)>
Public Shared Function MSChapSrvChangePassword(
    <MarshalAs(UnmanagedType.LPWStr)> ServerName As String,   ' LPWSTR
    <MarshalAs(UnmanagedType.LPWStr)> UserName As String,   ' LPWSTR
    <MarshalAs(UnmanagedType.U1)> LmOldPresent As Boolean,   ' BOOLEAN
    LmOldOwfPassword As IntPtr,   ' LM_OWF_PASSWORD*
    LmNewOwfPassword As IntPtr,   ' LM_OWF_PASSWORD*
    NtOldOwfPassword As IntPtr,   ' LM_OWF_PASSWORD*
    NtNewOwfPassword As IntPtr   ' LM_OWF_PASSWORD*
) As UInteger
End Function

' ServerName : LPWSTR
' UserName : LPWSTR
' LmOldPresent : BOOLEAN
' LmOldOwfPassword : LM_OWF_PASSWORD*
' LmNewOwfPassword : LM_OWF_PASSWORD*
' NtOldOwfPassword : LM_OWF_PASSWORD*
' NtNewOwfPassword : LM_OWF_PASSWORD*
Declare PtrSafe Function MSChapSrvChangePassword Lib "advapi32" ( _
    ByVal ServerName As LongPtr, _
    ByVal UserName As LongPtr, _
    ByVal LmOldPresent As Byte, _
    ByVal LmOldOwfPassword As LongPtr, _
    ByVal LmNewOwfPassword As LongPtr, _
    ByVal NtOldOwfPassword As LongPtr, _
    ByVal NtNewOwfPassword As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

MSChapSrvChangePassword = ctypes.windll.advapi32.MSChapSrvChangePassword
MSChapSrvChangePassword.restype = wintypes.DWORD
MSChapSrvChangePassword.argtypes = [
    wintypes.LPCWSTR,  # ServerName : LPWSTR
    wintypes.LPCWSTR,  # UserName : LPWSTR
    ctypes.c_byte,  # LmOldPresent : BOOLEAN
    ctypes.c_void_p,  # LmOldOwfPassword : LM_OWF_PASSWORD*
    ctypes.c_void_p,  # LmNewOwfPassword : LM_OWF_PASSWORD*
    ctypes.c_void_p,  # NtOldOwfPassword : LM_OWF_PASSWORD*
    ctypes.c_void_p,  # NtNewOwfPassword : LM_OWF_PASSWORD*
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ADVAPI32.dll')
MSChapSrvChangePassword = Fiddle::Function.new(
  lib['MSChapSrvChangePassword'],
  [
    Fiddle::TYPE_VOIDP,  # ServerName : LPWSTR
    Fiddle::TYPE_VOIDP,  # UserName : LPWSTR
    Fiddle::TYPE_CHAR,  # LmOldPresent : BOOLEAN
    Fiddle::TYPE_VOIDP,  # LmOldOwfPassword : LM_OWF_PASSWORD*
    Fiddle::TYPE_VOIDP,  # LmNewOwfPassword : LM_OWF_PASSWORD*
    Fiddle::TYPE_VOIDP,  # NtOldOwfPassword : LM_OWF_PASSWORD*
    Fiddle::TYPE_VOIDP,  # NtNewOwfPassword : LM_OWF_PASSWORD*
  ],
  -Fiddle::TYPE_INT)

#[link(name = "advapi32")]
extern "system" {
    fn MSChapSrvChangePassword(
        ServerName: *mut u16,  // LPWSTR
        UserName: *mut u16,  // LPWSTR
        LmOldPresent: u8,  // BOOLEAN
        LmOldOwfPassword: *mut LM_OWF_PASSWORD,  // LM_OWF_PASSWORD*
        LmNewOwfPassword: *mut LM_OWF_PASSWORD,  // LM_OWF_PASSWORD*
        NtOldOwfPassword: *mut LM_OWF_PASSWORD,  // LM_OWF_PASSWORD*
        NtNewOwfPassword: *mut LM_OWF_PASSWORD  // LM_OWF_PASSWORD*
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("ADVAPI32.dll")]
public static extern uint MSChapSrvChangePassword([MarshalAs(UnmanagedType.LPWStr)] string ServerName, [MarshalAs(UnmanagedType.LPWStr)] string UserName, [MarshalAs(UnmanagedType.U1)] bool LmOldPresent, IntPtr LmOldOwfPassword, IntPtr LmNewOwfPassword, IntPtr NtOldOwfPassword, IntPtr NtNewOwfPassword);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ADVAPI32_MSChapSrvChangePassword' -Namespace Win32 -PassThru
# $api::MSChapSrvChangePassword(ServerName, UserName, LmOldPresent, LmOldOwfPassword, LmNewOwfPassword, NtOldOwfPassword, NtNewOwfPassword)

#uselib "ADVAPI32.dll"
#func global MSChapSrvChangePassword "MSChapSrvChangePassword" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; MSChapSrvChangePassword ServerName, UserName, LmOldPresent, varptr(LmOldOwfPassword), varptr(LmNewOwfPassword), varptr(NtOldOwfPassword), varptr(NtNewOwfPassword)   ; 戻り値は stat
; ServerName : LPWSTR -> "sptr"
; UserName : LPWSTR -> "sptr"
; LmOldPresent : BOOLEAN -> "sptr"
; LmOldOwfPassword : LM_OWF_PASSWORD* -> "sptr"
; LmNewOwfPassword : LM_OWF_PASSWORD* -> "sptr"
; NtOldOwfPassword : LM_OWF_PASSWORD* -> "sptr"
; NtNewOwfPassword : LM_OWF_PASSWORD* -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

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

出力引数:

; DWORD MSChapSrvChangePassword(LPWSTR ServerName, LPWSTR UserName, BOOLEAN LmOldPresent, LM_OWF_PASSWORD* LmOldOwfPassword, LM_OWF_PASSWORD* LmNewOwfPassword, LM_OWF_PASSWORD* NtOldOwfPassword, LM_OWF_PASSWORD* NtNewOwfPassword)
#uselib "ADVAPI32.dll"
#cfunc global MSChapSrvChangePassword "MSChapSrvChangePassword" wstr, wstr, int, var, var, var, var
; res = MSChapSrvChangePassword(ServerName, UserName, LmOldPresent, LmOldOwfPassword, LmNewOwfPassword, NtOldOwfPassword, NtNewOwfPassword)
; ServerName : LPWSTR -> "wstr"
; UserName : LPWSTR -> "wstr"
; LmOldPresent : BOOLEAN -> "int"
; LmOldOwfPassword : LM_OWF_PASSWORD* -> "var"
; LmNewOwfPassword : LM_OWF_PASSWORD* -> "var"
; NtOldOwfPassword : LM_OWF_PASSWORD* -> "var"
; NtNewOwfPassword : LM_OWF_PASSWORD* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD MSChapSrvChangePassword(LPWSTR ServerName, LPWSTR UserName, BOOLEAN LmOldPresent, LM_OWF_PASSWORD* LmOldOwfPassword, LM_OWF_PASSWORD* LmNewOwfPassword, LM_OWF_PASSWORD* NtOldOwfPassword, LM_OWF_PASSWORD* NtNewOwfPassword)
#uselib "ADVAPI32.dll"
#cfunc global MSChapSrvChangePassword "MSChapSrvChangePassword" wstr, wstr, int, intptr, intptr, intptr, intptr
; res = MSChapSrvChangePassword(ServerName, UserName, LmOldPresent, varptr(LmOldOwfPassword), varptr(LmNewOwfPassword), varptr(NtOldOwfPassword), varptr(NtNewOwfPassword))
; ServerName : LPWSTR -> "wstr"
; UserName : LPWSTR -> "wstr"
; LmOldPresent : BOOLEAN -> "int"
; LmOldOwfPassword : LM_OWF_PASSWORD* -> "intptr"
; LmNewOwfPassword : LM_OWF_PASSWORD* -> "intptr"
; NtOldOwfPassword : LM_OWF_PASSWORD* -> "intptr"
; NtNewOwfPassword : LM_OWF_PASSWORD* -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	advapi32 = windows.NewLazySystemDLL("ADVAPI32.dll")
	procMSChapSrvChangePassword = advapi32.NewProc("MSChapSrvChangePassword")
)

// ServerName (LPWSTR), UserName (LPWSTR), LmOldPresent (BOOLEAN), LmOldOwfPassword (LM_OWF_PASSWORD*), LmNewOwfPassword (LM_OWF_PASSWORD*), NtOldOwfPassword (LM_OWF_PASSWORD*), NtNewOwfPassword (LM_OWF_PASSWORD*)
r1, _, err := procMSChapSrvChangePassword.Call(
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(ServerName))),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(UserName))),
	uintptr(LmOldPresent),
	uintptr(LmOldOwfPassword),
	uintptr(LmNewOwfPassword),
	uintptr(NtOldOwfPassword),
	uintptr(NtNewOwfPassword),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD

function MSChapSrvChangePassword(
  ServerName: PWideChar;   // LPWSTR
  UserName: PWideChar;   // LPWSTR
  LmOldPresent: ByteBool;   // BOOLEAN
  LmOldOwfPassword: Pointer;   // LM_OWF_PASSWORD*
  LmNewOwfPassword: Pointer;   // LM_OWF_PASSWORD*
  NtOldOwfPassword: Pointer;   // LM_OWF_PASSWORD*
  NtNewOwfPassword: Pointer   // LM_OWF_PASSWORD*
): DWORD; stdcall;
  external 'ADVAPI32.dll' name 'MSChapSrvChangePassword';

result := DllCall("ADVAPI32\MSChapSrvChangePassword"
    , "WStr", ServerName   ; LPWSTR
    , "WStr", UserName   ; LPWSTR
    , "Char", LmOldPresent   ; BOOLEAN
    , "Ptr", LmOldOwfPassword   ; LM_OWF_PASSWORD*
    , "Ptr", LmNewOwfPassword   ; LM_OWF_PASSWORD*
    , "Ptr", NtOldOwfPassword   ; LM_OWF_PASSWORD*
    , "Ptr", NtNewOwfPassword   ; LM_OWF_PASSWORD*
    , "UInt")   ; return: DWORD

●MSChapSrvChangePassword(ServerName, UserName, LmOldPresent, LmOldOwfPassword, LmNewOwfPassword, NtOldOwfPassword, NtNewOwfPassword) = DLL("ADVAPI32.dll", "dword MSChapSrvChangePassword(char*, char*, byte, void*, void*, void*, void*)")
# 呼び出し: MSChapSrvChangePassword(ServerName, UserName, LmOldPresent, LmOldOwfPassword, LmNewOwfPassword, NtOldOwfPassword, NtNewOwfPassword)
# ServerName : LPWSTR -> "char*"
# UserName : LPWSTR -> "char*"
# LmOldPresent : BOOLEAN -> "byte"
# LmOldOwfPassword : LM_OWF_PASSWORD* -> "void*"
# LmNewOwfPassword : LM_OWF_PASSWORD* -> "void*"
# NtOldOwfPassword : LM_OWF_PASSWORD* -> "void*"
# NtNewOwfPassword : LM_OWF_PASSWORD* -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。