USER_INFO_1020
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| usri1020_units_per_week | DWORD | 4 | +0 | +0 | 1 週間を分割する等長の時間単位の数を示す DWORD 値を指定します。この値は、usri1020_logon_hours メンバーのビット文字列の長さを計算するために必要です。 LAN Manager 2.0 の場合、この値は UNITS_PER_WEEK でなければなりません。 NetUserAdd 関数および NetUserSetInfo 関数の呼び出しでは、このメンバーは無視されます。 サービスアプリケーションの場合、単位は SAM_DAYS_PER_WEEK、SAM_HOURS_PER_WEEK、SAM_MINUTES_PER_WEEK のいずれかの値でなければなりません。 |
| usri1020_logon_hours | BYTE* | 8/4 | +8 | +4 | ユーザーがログオンできる時間帯を指定する 21 バイト (168 ビット) のビット文字列へのポインターです。対象のユーザーは、 NetUserSetInfo 関数の username パラメーターで指定します。 文字列の各ビットは、グリニッジ標準時 (GMT) における 1 週間の各時間を表します。最初のビット (ビット 0、ワード 0) は日曜日の 0:00 から 0:59、2 番目のビット (ビット 1、ワード 0) は日曜日の 1:00 から 1:59 を表し、以降も同様です。ワード 0 のビット 0 が日曜日の 0:00 から 0:59 を表すのは、GMT タイムゾーンにいる場合のみである点に注意してください。それ以外の場合は、タイムゾーンのオフセットに応じてビットを調整する必要があります (たとえば、太平洋標準時では GMT から 8 時間を引きます)。 |
公式ドキュメント
<b>USER_INFO_1020</b> 構造体は、ユーザーがネットワークにログオンできる時間帯を格納します。この情報レベルは、
NetUserSetInfo 関数を呼び出す場合にのみ有効です。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// USER_INFO_1020 (x64 16 / x86 8 バイト)
typedef struct USER_INFO_1020 {
DWORD usri1020_units_per_week;
BYTE* usri1020_logon_hours;
} USER_INFO_1020;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct USER_INFO_1020
{
public uint usri1020_units_per_week;
public IntPtr usri1020_logon_hours;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure USER_INFO_1020
Public usri1020_units_per_week As UInteger
Public usri1020_logon_hours As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class USER_INFO_1020(ctypes.Structure):
_fields_ = [
("usri1020_units_per_week", wintypes.DWORD),
("usri1020_logon_hours", ctypes.c_void_p),
]#[repr(C)]
pub struct USER_INFO_1020 {
pub usri1020_units_per_week: u32,
pub usri1020_logon_hours: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type USER_INFO_1020 struct {
usri1020_units_per_week uint32
usri1020_logon_hours uintptr
}type
USER_INFO_1020 = record
usri1020_units_per_week: DWORD;
usri1020_logon_hours: Pointer;
end;const USER_INFO_1020 = extern struct {
usri1020_units_per_week: u32,
usri1020_logon_hours: ?*anyopaque,
};type
USER_INFO_1020 {.bycopy.} = object
usri1020_units_per_week: uint32
usri1020_logon_hours: pointerstruct USER_INFO_1020
{
uint usri1020_units_per_week;
void* usri1020_logon_hours;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; USER_INFO_1020 サイズ: 8 バイト(x86)
dim st, 2 ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; usri1020_units_per_week : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; usri1020_logon_hours : BYTE* (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; USER_INFO_1020 サイズ: 16 バイト(x64)
dim st, 4 ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; usri1020_units_per_week : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; usri1020_logon_hours : BYTE* (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global USER_INFO_1020
#field int usri1020_units_per_week
#field intptr usri1020_logon_hours
#endstruct
stdim st, USER_INFO_1020 ; NSTRUCT 変数を確保
st->usri1020_units_per_week = 100
mes "usri1020_units_per_week=" + st->usri1020_units_per_week