Win32 API 日本語リファレンス
ホームNetworkManagement.NetManagement › USER_MODALS_INFO_0

USER_MODALS_INFO_0

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

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

フィールド

フィールドサイズx64x86説明
usrmod0_min_passwd_lenDWORD4+0+0許容されるパスワードの最小長を指定します。この要素の有効な値は 0 から LM20_PWLEN までです。
usrmod0_max_passwd_ageDWORD4+4+4許容されるパスワードの最長有効期間を秒単位で指定します。TIMEQ_FOREVER を指定すると、パスワードは期限切れになりません。この要素の有効な最小値は ONE_DAY です。指定する値は usrmod0_min_passwd_age メンバーの値以上でなければなりません。
usrmod0_min_passwd_ageDWORD4+8+8パスワードが変更されてから再度変更できるようになるまでに経過する必要がある最小の秒数を指定します。0 を指定すると、パスワードの更新間隔に遅延は不要となります。指定する値は usrmod0_max_passwd_age メンバーの値以下でなければなりません。
usrmod0_force_logoffDWORD4+12+12有効なログオン時間の終了から、ユーザーがネットワークから強制的にログオフされるまでの時間を秒単位で指定します。TIMEQ_FOREVER を指定すると、ユーザーが強制的にログオフされることはありません。0 を指定すると、有効なログオン時間が終了した時点でユーザーはただちに強制ログオフされます。
usrmod0_password_hist_lenDWORD4+16+16保持されるパスワード履歴の長さを指定します。新しいパスワードは、直前の usrmod0_password_hist_len 個のパスワードのいずれとも一致してはなりません。この要素の有効な値は 0 から DEF_MAX_PWHIST までです。

公式ドキュメント

            <b>USER_MODALS_INFO_0</b> 構造体には、セキュリティ データベース (セキュリティ アカウント マネージャー (SAM) データベース、ドメイン コントローラーの場合は Active Directory) 内のユーザーおよびグローバル グループに関するグローバルなパスワード情報が格納されます。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// USER_MODALS_INFO_0  (x64 20 / x86 20 バイト)
typedef struct USER_MODALS_INFO_0 {
    DWORD usrmod0_min_passwd_len;
    DWORD usrmod0_max_passwd_age;
    DWORD usrmod0_min_passwd_age;
    DWORD usrmod0_force_logoff;
    DWORD usrmod0_password_hist_len;
} USER_MODALS_INFO_0;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct USER_MODALS_INFO_0
{
    public uint usrmod0_min_passwd_len;
    public uint usrmod0_max_passwd_age;
    public uint usrmod0_min_passwd_age;
    public uint usrmod0_force_logoff;
    public uint usrmod0_password_hist_len;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure USER_MODALS_INFO_0
    Public usrmod0_min_passwd_len As UInteger
    Public usrmod0_max_passwd_age As UInteger
    Public usrmod0_min_passwd_age As UInteger
    Public usrmod0_force_logoff As UInteger
    Public usrmod0_password_hist_len As UInteger
End Structure
import ctypes
from ctypes import wintypes

class USER_MODALS_INFO_0(ctypes.Structure):
    _fields_ = [
        ("usrmod0_min_passwd_len", wintypes.DWORD),
        ("usrmod0_max_passwd_age", wintypes.DWORD),
        ("usrmod0_min_passwd_age", wintypes.DWORD),
        ("usrmod0_force_logoff", wintypes.DWORD),
        ("usrmod0_password_hist_len", wintypes.DWORD),
    ]
#[repr(C)]
pub struct USER_MODALS_INFO_0 {
    pub usrmod0_min_passwd_len: u32,
    pub usrmod0_max_passwd_age: u32,
    pub usrmod0_min_passwd_age: u32,
    pub usrmod0_force_logoff: u32,
    pub usrmod0_password_hist_len: u32,
}
import "golang.org/x/sys/windows"

type USER_MODALS_INFO_0 struct {
	usrmod0_min_passwd_len uint32
	usrmod0_max_passwd_age uint32
	usrmod0_min_passwd_age uint32
	usrmod0_force_logoff uint32
	usrmod0_password_hist_len uint32
}
type
  USER_MODALS_INFO_0 = record
    usrmod0_min_passwd_len: DWORD;
    usrmod0_max_passwd_age: DWORD;
    usrmod0_min_passwd_age: DWORD;
    usrmod0_force_logoff: DWORD;
    usrmod0_password_hist_len: DWORD;
  end;
const USER_MODALS_INFO_0 = extern struct {
    usrmod0_min_passwd_len: u32,
    usrmod0_max_passwd_age: u32,
    usrmod0_min_passwd_age: u32,
    usrmod0_force_logoff: u32,
    usrmod0_password_hist_len: u32,
};
type
  USER_MODALS_INFO_0 {.bycopy.} = object
    usrmod0_min_passwd_len: uint32
    usrmod0_max_passwd_age: uint32
    usrmod0_min_passwd_age: uint32
    usrmod0_force_logoff: uint32
    usrmod0_password_hist_len: uint32
struct USER_MODALS_INFO_0
{
    uint usrmod0_min_passwd_len;
    uint usrmod0_max_passwd_age;
    uint usrmod0_min_passwd_age;
    uint usrmod0_force_logoff;
    uint usrmod0_password_hist_len;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; USER_MODALS_INFO_0 サイズ: 20 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; usrmod0_min_passwd_len : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; usrmod0_max_passwd_age : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; usrmod0_min_passwd_age : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; usrmod0_force_logoff : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; usrmod0_password_hist_len : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global USER_MODALS_INFO_0
    #field int usrmod0_min_passwd_len
    #field int usrmod0_max_passwd_age
    #field int usrmod0_min_passwd_age
    #field int usrmod0_force_logoff
    #field int usrmod0_password_hist_len
#endstruct

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