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

USER_INFO_1020

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

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

フィールド

フィールドサイズx64x86説明
usri1020_units_per_weekDWORD4+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_hoursBYTE*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 の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: pointer
struct 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