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

MSV1_0_LM20_LOGON

構造体
サイズx64: 104 バイト / x86: 56 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
MessageTypeMSV1_0_LOGON_SUBMIT_TYPE4+0+0

要求するログオンの種類を指定する MSV1_0_LOGON_SUBMIT_TYPE 値です。このメンバーには MsV1_0Lm20Logon または MsV1_0NetworkLogon を設定しなければなりません。

このメンバーに MsV1_0Lm20Logon を設定した場合、MSV1_0 パッケージは ParameterControl メンバーを無視します。

LogonDomainNameLSA_UNICODE_STRING16/8+8+4ログオンドメインの名前を格納する UNICODE_STRING です。指定するドメイン名は、このコンピューターの信頼されたドメインの一覧に含まれる Windows ドメイン (または混在モードのドメイン) でなければなりません。ログオンドメイン名が不明な場合 (たとえば、この情報を提供しないクライアントの場合) は、このメンバーには長さ 0 の文字列を渡します。このドメインが認証を行う機関となります。
UserNameLSA_UNICODE_STRING16/8+24+12ユーザーのアカウント名を表す UNICODE_STRING です。名前の長さは最大 255 バイトです。名前は大文字と小文字を区別せずに扱われます。
WorkstationLSA_UNICODE_STRING16/8+40+20ユーザーのログオン要求が開始されたクライアントワークステーションのコンピューター名を格納する UNICODE_STRING です。
ChallengeToClientBYTE8+56+28メッセージの種類として MsV1_0Lm20ChallengeRequest を指定して以前に LsaCallAuthenticationPackage を呼び出したときに返されたチャレンジを格納します。詳細については、 MSV1_0_PROTOCOL_MESSAGE_TYPEMsV1_0Lm20ChallengeRequest の説明を参照してください。これにより、認証パッケージはチャレンジ応答が正しいかどうかを判断できます。
CaseSensitiveChallengeResponseLSA_STRING16/8+64+36

クライアントの大文字と小文字を区別する Unicode パスワードから求めた値を格納します。通常は、大文字と小文字を区別する形式のパスワードで ChallengeToClient メンバーを暗号化したものになります。

クライアントによっては、大文字と小文字を区別する Unicode パスワードを平文のまま渡すだけのものもあります。その場合、このメンバーはその平文のパスワードを指します。 MSV1_0 認証パッケージは、構成オプションによってはこの暗号化されていない形式を受け入れることがあります。

クライアントによっては、大文字と小文字を区別する Unicode パスワードをサポートしないものもあります。その場合、このメンバーには長さ 0 の文字列を格納します。

CaseInsensitiveChallengeResponseLSA_STRING16/8+80+44

クライアントの大文字と小文字を区別しないマルチバイト文字セット (MBCS) パスワードから求めた値を格納します。通常は、大文字と小文字を区別しない形式のパスワードで ChallengeToClient メンバーを暗号化したものになります。

Unicode をサポートせず MBCS のみをサポートするクライアントは、大文字と小文字を区別しない MBCS パスワードを平文で渡します。その場合、このメンバーはその平文のパスワードを指します。MSV1_0 認証パッケージは、構成オプションによってはこの暗号化されていない形式を受け入れます。

ParameterControlDWORD4+96+52

他のパラメーターの属性を指定します。次のフラグを 1 つ以上指定できます。

意味
MSV1_0_CLEARTEXT_PASSWORD_ALLOWED
02
LanMan2.0 および LanMan1.0 は、チャレンジ応答の代わりに平文のパスワードを送信します。NetworkLogon メッセージで平文のパスワードを使用できるようにするには、アプリケーションがこのフラグを指定する必要があります。
MSV1_0_UPDATE_LOGON_STATISTICS
04
アカウントのログオン統計情報を更新します。このフラグが設定されていない場合、ログオンが成功すると不正なパスワードのカウントは 0 に設定されます。
MSV1_0_RETURN_USER_PARAMETERS
08
このフラグを指定すると、 MSV1_0_LM20_LOGON_PROFILE の戻りバッファーの UserParameters メンバーが有効になります。
MSV1_0_DONT_TRY_GUEST_ACCOUNT
10
ゲストアカウントでのログオンを禁止します。
MSV1_0_ALLOW_SERVER_TRUST_ACCOUNT
20
このフラグが設定されている場合、認証にドメインコントローラーのアカウントを使用できます。設定されていない場合は、ユーザーアカウントのみを使用できます。
MSV1_0_RETURN_PASSWORD_EXPIRY
40
出力バッファーで返される MSV1_0_LM20_LOGON_PROFILE 構造体の LogoffTime メンバーに、パスワードの有効期限を返します。
MSV1_0_USE_CLIENT_CHALLENGE
80
CaseInsensitiveChallengeResponse の先頭 8 バイトにクライアントチャレンジが格納されていることを示します。
MSV1_0_TRY_GUEST_ACCOUNT_ONLY
100
ゲストアカウントを使用してユーザーをログオンさせます。
MSV1_0_RETURN_PROFILE_PATH
200
暗号化ファイルシステム (EFS) 用のプロファイルパスを返します。プロファイルパスは、EFS がユーザーのプロファイルを見つけ、ファイルの暗号化と復号に使用するユーザーのキーを検索するために使用されます。この情報は呼び出し元には返されず、LSA 内に格納されて内部処理で使用されます。
MSV1_0_TRY_SPECIFIED_DOMAIN_ONLY
400
通常の動作では、LogonDomainName メンバーは候補として使用されます。パッケージは (NetLogon サービスを使用して)、信頼されたドメインのパス上のより上位のドメインコントローラーへログオン要求を渡し続け、いずれかが権限を持ってログオンを拒否するまで処理を続けます。

このフラグはその動作を上書きし、指定したドメインコントローラーだけがログオンの処理を試みるようにします。LogonDomainName が空の場合、ログオンは試行されません。

MSV1_0_ALLOW_WORKSTATION_TRUST_ACCOUNT
800
リモートブートクライアントがコンピューターアカウントを使用してログオンすることを許可します。
MSV1_0_CLEARTEXT_PASSWORD_SUPPLIED
4000
平文のパスワードの使用を許可します。

Windows XP および Windows Server 2003: サポートされていません。

MSV1_0_USE_DOMAIN_FOR_ROUTING_ONLY
8000
ドメインをルーティングのみに使用することを許可します。

Windows XP および Windows Server 2003: サポートされていません。

MSV1_0_ALLOW_MSVCHAPV2
10000
SubAuthentication によるログオンを許可します。

Windows XP および Windows Server 2003: サポートされていません。

MSV1_0_S4U2SELF
20000
S4U クライアントがパスワードなしでログオンすることを許可します。

Windows Vista、SP2 適用の Windows Server 2003、Windows XP および Windows Server 2003: サポートされていません。

MSV1_0_CHECK_LOGONHOURS_FOR_S4U
40000
S4U ログオンクライアントのログオン可能時間を確認します。

Windows Vista、SP2 適用の Windows Server 2003、Windows XP および Windows Server 2003: サポートされていません。

MSV1_0_INTERNET_DOMAIN
80000
インターネットユーザーのログオンを許可します。このフラグは、netlogon からではなく、認証パッケージから直接行う呼び出しで使用してください。

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP および Windows Server 2003: サポートされていません。

公式ドキュメント

MSV1_0_LM20_LOGON 構造体は、ネットワークログオンで使用されるログオン情報を格納します。

この構造体は LsaLogonUser で使用されます。

解説(Remarks)

UserNameCaseSensitiveChallengeResponseCaseInsensitiveChallengeResponse の各メンバーがすべて長さ 0 の文字列である場合、そのログオンに対して匿名トークンが生成されます。この匿名トークンでは、保護されたシステムリソースにはアクセスできませんが、保護されていないシステムリソースへのアクセスは可能です。サーバーはこの方法で NULL セッションをサポートします。

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

各言語での定義

#include <windows.h>

// LSA_UNICODE_STRING  (x64 16 / x86 8 バイト)
typedef struct LSA_UNICODE_STRING {
    WORD Length;
    WORD MaximumLength;
    LPWSTR Buffer;
} LSA_UNICODE_STRING;

// LSA_STRING  (x64 16 / x86 8 バイト)
typedef struct LSA_STRING {
    WORD Length;
    WORD MaximumLength;
    LPSTR Buffer;
} LSA_STRING;

// MSV1_0_LM20_LOGON  (x64 104 / x86 56 バイト)
typedef struct MSV1_0_LM20_LOGON {
    MSV1_0_LOGON_SUBMIT_TYPE MessageType;
    LSA_UNICODE_STRING LogonDomainName;
    LSA_UNICODE_STRING UserName;
    LSA_UNICODE_STRING Workstation;
    BYTE ChallengeToClient[8];
    LSA_STRING CaseSensitiveChallengeResponse;
    LSA_STRING CaseInsensitiveChallengeResponse;
    DWORD ParameterControl;
} MSV1_0_LM20_LOGON;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LSA_UNICODE_STRING
{
    public ushort Length;
    public ushort MaximumLength;
    public IntPtr Buffer;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LSA_STRING
{
    public ushort Length;
    public ushort MaximumLength;
    public IntPtr Buffer;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MSV1_0_LM20_LOGON
{
    public int MessageType;
    public LSA_UNICODE_STRING LogonDomainName;
    public LSA_UNICODE_STRING UserName;
    public LSA_UNICODE_STRING Workstation;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public byte[] ChallengeToClient;
    public LSA_STRING CaseSensitiveChallengeResponse;
    public LSA_STRING CaseInsensitiveChallengeResponse;
    public uint ParameterControl;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LSA_UNICODE_STRING
    Public Length As UShort
    Public MaximumLength As UShort
    Public Buffer As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LSA_STRING
    Public Length As UShort
    Public MaximumLength As UShort
    Public Buffer As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MSV1_0_LM20_LOGON
    Public MessageType As Integer
    Public LogonDomainName As LSA_UNICODE_STRING
    Public UserName As LSA_UNICODE_STRING
    Public Workstation As LSA_UNICODE_STRING
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public ChallengeToClient() As Byte
    Public CaseSensitiveChallengeResponse As LSA_STRING
    Public CaseInsensitiveChallengeResponse As LSA_STRING
    Public ParameterControl As UInteger
End Structure
import ctypes
from ctypes import wintypes

class LSA_UNICODE_STRING(ctypes.Structure):
    _fields_ = [
        ("Length", ctypes.c_ushort),
        ("MaximumLength", ctypes.c_ushort),
        ("Buffer", ctypes.c_void_p),
    ]

class LSA_STRING(ctypes.Structure):
    _fields_ = [
        ("Length", ctypes.c_ushort),
        ("MaximumLength", ctypes.c_ushort),
        ("Buffer", ctypes.c_void_p),
    ]

class MSV1_0_LM20_LOGON(ctypes.Structure):
    _fields_ = [
        ("MessageType", ctypes.c_int),
        ("LogonDomainName", LSA_UNICODE_STRING),
        ("UserName", LSA_UNICODE_STRING),
        ("Workstation", LSA_UNICODE_STRING),
        ("ChallengeToClient", ctypes.c_ubyte * 8),
        ("CaseSensitiveChallengeResponse", LSA_STRING),
        ("CaseInsensitiveChallengeResponse", LSA_STRING),
        ("ParameterControl", wintypes.DWORD),
    ]
#[repr(C)]
pub struct LSA_UNICODE_STRING {
    pub Length: u16,
    pub MaximumLength: u16,
    pub Buffer: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct LSA_STRING {
    pub Length: u16,
    pub MaximumLength: u16,
    pub Buffer: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct MSV1_0_LM20_LOGON {
    pub MessageType: i32,
    pub LogonDomainName: LSA_UNICODE_STRING,
    pub UserName: LSA_UNICODE_STRING,
    pub Workstation: LSA_UNICODE_STRING,
    pub ChallengeToClient: [u8; 8],
    pub CaseSensitiveChallengeResponse: LSA_STRING,
    pub CaseInsensitiveChallengeResponse: LSA_STRING,
    pub ParameterControl: u32,
}
import "golang.org/x/sys/windows"

type LSA_UNICODE_STRING struct {
	Length uint16
	MaximumLength uint16
	Buffer uintptr
}

type LSA_STRING struct {
	Length uint16
	MaximumLength uint16
	Buffer uintptr
}

type MSV1_0_LM20_LOGON struct {
	MessageType int32
	LogonDomainName LSA_UNICODE_STRING
	UserName LSA_UNICODE_STRING
	Workstation LSA_UNICODE_STRING
	ChallengeToClient [8]byte
	CaseSensitiveChallengeResponse LSA_STRING
	CaseInsensitiveChallengeResponse LSA_STRING
	ParameterControl uint32
}
type
  LSA_UNICODE_STRING = record
    Length: Word;
    MaximumLength: Word;
    Buffer: Pointer;
  end;

  LSA_STRING = record
    Length: Word;
    MaximumLength: Word;
    Buffer: Pointer;
  end;

  MSV1_0_LM20_LOGON = record
    MessageType: Integer;
    LogonDomainName: LSA_UNICODE_STRING;
    UserName: LSA_UNICODE_STRING;
    Workstation: LSA_UNICODE_STRING;
    ChallengeToClient: array[0..7] of Byte;
    CaseSensitiveChallengeResponse: LSA_STRING;
    CaseInsensitiveChallengeResponse: LSA_STRING;
    ParameterControl: DWORD;
  end;
const LSA_UNICODE_STRING = extern struct {
    Length: u16,
    MaximumLength: u16,
    Buffer: ?*anyopaque,
};

const LSA_STRING = extern struct {
    Length: u16,
    MaximumLength: u16,
    Buffer: ?*anyopaque,
};

const MSV1_0_LM20_LOGON = extern struct {
    MessageType: i32,
    LogonDomainName: LSA_UNICODE_STRING,
    UserName: LSA_UNICODE_STRING,
    Workstation: LSA_UNICODE_STRING,
    ChallengeToClient: [8]u8,
    CaseSensitiveChallengeResponse: LSA_STRING,
    CaseInsensitiveChallengeResponse: LSA_STRING,
    ParameterControl: u32,
};
type
  LSA_UNICODE_STRING {.bycopy.} = object
    Length: uint16
    MaximumLength: uint16
    Buffer: pointer

  LSA_STRING {.bycopy.} = object
    Length: uint16
    MaximumLength: uint16
    Buffer: pointer

  MSV1_0_LM20_LOGON {.bycopy.} = object
    MessageType: int32
    LogonDomainName: LSA_UNICODE_STRING
    UserName: LSA_UNICODE_STRING
    Workstation: LSA_UNICODE_STRING
    ChallengeToClient: array[8, uint8]
    CaseSensitiveChallengeResponse: LSA_STRING
    CaseInsensitiveChallengeResponse: LSA_STRING
    ParameterControl: uint32
struct LSA_UNICODE_STRING
{
    ushort Length;
    ushort MaximumLength;
    void* Buffer;
}

struct LSA_STRING
{
    ushort Length;
    ushort MaximumLength;
    void* Buffer;
}

struct MSV1_0_LM20_LOGON
{
    int MessageType;
    LSA_UNICODE_STRING LogonDomainName;
    LSA_UNICODE_STRING UserName;
    LSA_UNICODE_STRING Workstation;
    ubyte[8] ChallengeToClient;
    LSA_STRING CaseSensitiveChallengeResponse;
    LSA_STRING CaseInsensitiveChallengeResponse;
    uint ParameterControl;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; MSV1_0_LM20_LOGON サイズ: 56 バイト(x86)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; MessageType : MSV1_0_LOGON_SUBMIT_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; LogonDomainName : LSA_UNICODE_STRING (+4, 8byte)  varptr(st)+4 を基点に操作(8byte:入れ子/配列)
; UserName : LSA_UNICODE_STRING (+12, 8byte)  varptr(st)+12 を基点に操作(8byte:入れ子/配列)
; Workstation : LSA_UNICODE_STRING (+20, 8byte)  varptr(st)+20 を基点に操作(8byte:入れ子/配列)
; ChallengeToClient : BYTE (+28, 8byte)  varptr(st)+28 を基点に操作(8byte:入れ子/配列)
; CaseSensitiveChallengeResponse : LSA_STRING (+36, 8byte)  varptr(st)+36 を基点に操作(8byte:入れ子/配列)
; CaseInsensitiveChallengeResponse : LSA_STRING (+44, 8byte)  varptr(st)+44 を基点に操作(8byte:入れ子/配列)
; ParameterControl : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MSV1_0_LM20_LOGON サイズ: 104 バイト(x64)
dim st, 26    ; 4byte整数×26(構造体サイズ 104 / 4 切り上げ)
; MessageType : MSV1_0_LOGON_SUBMIT_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; LogonDomainName : LSA_UNICODE_STRING (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; UserName : LSA_UNICODE_STRING (+24, 16byte)  varptr(st)+24 を基点に操作(16byte:入れ子/配列)
; Workstation : LSA_UNICODE_STRING (+40, 16byte)  varptr(st)+40 を基点に操作(16byte:入れ子/配列)
; ChallengeToClient : BYTE (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; CaseSensitiveChallengeResponse : LSA_STRING (+64, 16byte)  varptr(st)+64 を基点に操作(16byte:入れ子/配列)
; CaseInsensitiveChallengeResponse : LSA_STRING (+80, 16byte)  varptr(st)+80 を基点に操作(16byte:入れ子/配列)
; ParameterControl : DWORD (+96, 4byte)  st.24 = 値  /  値 = st.24   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global LSA_UNICODE_STRING
    #field short Length
    #field short MaximumLength
    #field intptr Buffer
#endstruct

#defstruct global LSA_STRING
    #field short Length
    #field short MaximumLength
    #field intptr Buffer
#endstruct

#defstruct global MSV1_0_LM20_LOGON
    #field int MessageType
    #field LSA_UNICODE_STRING LogonDomainName
    #field LSA_UNICODE_STRING UserName
    #field LSA_UNICODE_STRING Workstation
    #field byte ChallengeToClient 8
    #field LSA_STRING CaseSensitiveChallengeResponse
    #field LSA_STRING CaseInsensitiveChallengeResponse
    #field int ParameterControl
#endstruct

stdim st, MSV1_0_LM20_LOGON        ; NSTRUCT 変数を確保
st->MessageType = 100
mes "MessageType=" + st->MessageType