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

DHCP_MIB_INFO

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 48 バイト / x86: 44 バイト

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

フィールド

フィールド型サイズx64x86説明
DiscoversDWORD4+0+0受信した DHCP 探索 (discover) メッセージの数を格納します。
OffersDWORD4+4+4送信した DHCP サービス オファー メッセージの数を格納します。
RequestsDWORD4+8+8受信した動的アドレス要求メッセージの数を格納します。
AcksDWORD4+12+12受信した DHCP ACK メッセージの数を格納します。
NaksDWORD4+16+16受信した DHCP NACK メッセージの数を格納します。
DeclinesDWORD4+20+20受信した動的アドレス サービス拒否 (decline) メッセージの数を格納します。
ReleasesDWORD4+24+24受信した動的アドレス解放 (release) メッセージの数を格納します。
ServerStartTimeDATE_TIME8+28+28DHCP サービスが開始された日時を格納する DATE_TIME 構造体です。
ScopesDWORD4+36+36DHCP サーバー上に定義されているスコープの数を格納します。
ScopeInfoSCOPE_MIB_INFO*8/4+40+40サーバー上に定義されている各サブネットの情報を格納する SCOPE_MIB_INFO 構造体の配列です。この配列の要素数はちょうど Scopes 個です。サブネットが 1 つも定義されていない場合 (Scopes が 0 の場合)、このフィールドは NULL になります。

公式ドキュメント

DHCP_MIB_INFO 構造体は、DHCP 固有の SNMP 管理情報ブロック (MIB) から返される、現在の DHCP サービスに関する情報を定義します。

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

各言語での定義

#include <windows.h>

// DATE_TIME  (x64 8 / x86 8 バイト)
typedef struct DATE_TIME {
    DWORD dwLowDateTime;
    DWORD dwHighDateTime;
} DATE_TIME;

// DHCP_MIB_INFO  (x64 48 / x86 44 バイト)
typedef struct DHCP_MIB_INFO {
    DWORD Discovers;
    DWORD Offers;
    DWORD Requests;
    DWORD Acks;
    DWORD Naks;
    DWORD Declines;
    DWORD Releases;
    DATE_TIME ServerStartTime;
    DWORD Scopes;
    SCOPE_MIB_INFO* ScopeInfo;
} DHCP_MIB_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DATE_TIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DHCP_MIB_INFO
{
    public uint Discovers;
    public uint Offers;
    public uint Requests;
    public uint Acks;
    public uint Naks;
    public uint Declines;
    public uint Releases;
    public DATE_TIME ServerStartTime;
    public uint Scopes;
    public IntPtr ScopeInfo;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DATE_TIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DHCP_MIB_INFO
    Public Discovers As UInteger
    Public Offers As UInteger
    Public Requests As UInteger
    Public Acks As UInteger
    Public Naks As UInteger
    Public Declines As UInteger
    Public Releases As UInteger
    Public ServerStartTime As DATE_TIME
    Public Scopes As UInteger
    Public ScopeInfo As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DATE_TIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class DHCP_MIB_INFO(ctypes.Structure):
    _fields_ = [
        ("Discovers", wintypes.DWORD),
        ("Offers", wintypes.DWORD),
        ("Requests", wintypes.DWORD),
        ("Acks", wintypes.DWORD),
        ("Naks", wintypes.DWORD),
        ("Declines", wintypes.DWORD),
        ("Releases", wintypes.DWORD),
        ("ServerStartTime", DATE_TIME),
        ("Scopes", wintypes.DWORD),
        ("ScopeInfo", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DATE_TIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct DHCP_MIB_INFO {
    pub Discovers: u32,
    pub Offers: u32,
    pub Requests: u32,
    pub Acks: u32,
    pub Naks: u32,
    pub Declines: u32,
    pub Releases: u32,
    pub ServerStartTime: DATE_TIME,
    pub Scopes: u32,
    pub ScopeInfo: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DATE_TIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type DHCP_MIB_INFO struct {
	Discovers uint32
	Offers uint32
	Requests uint32
	Acks uint32
	Naks uint32
	Declines uint32
	Releases uint32
	ServerStartTime DATE_TIME
	Scopes uint32
	ScopeInfo uintptr
}
type
  DATE_TIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  DHCP_MIB_INFO = record
    Discovers: DWORD;
    Offers: DWORD;
    Requests: DWORD;
    Acks: DWORD;
    Naks: DWORD;
    Declines: DWORD;
    Releases: DWORD;
    ServerStartTime: DATE_TIME;
    Scopes: DWORD;
    ScopeInfo: Pointer;
  end;
const DATE_TIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const DHCP_MIB_INFO = extern struct {
    Discovers: u32,
    Offers: u32,
    Requests: u32,
    Acks: u32,
    Naks: u32,
    Declines: u32,
    Releases: u32,
    ServerStartTime: DATE_TIME,
    Scopes: u32,
    ScopeInfo: ?*anyopaque,
};
type
  DATE_TIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  DHCP_MIB_INFO {.bycopy.} = object
    Discovers: uint32
    Offers: uint32
    Requests: uint32
    Acks: uint32
    Naks: uint32
    Declines: uint32
    Releases: uint32
    ServerStartTime: DATE_TIME
    Scopes: uint32
    ScopeInfo: pointer
struct DATE_TIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct DHCP_MIB_INFO
{
    uint Discovers;
    uint Offers;
    uint Requests;
    uint Acks;
    uint Naks;
    uint Declines;
    uint Releases;
    DATE_TIME ServerStartTime;
    uint Scopes;
    void* ScopeInfo;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DHCP_MIB_INFO サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; Discovers : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Offers : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Requests : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; Acks : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Naks : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; Declines : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; Releases : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ServerStartTime : DATE_TIME (+28, 8byte)  varptr(st)+28 を基点に操作(8byte:入れ子/配列)
; Scopes : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ScopeInfo : SCOPE_MIB_INFO* (+40, 4byte)  varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DHCP_MIB_INFO サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; Discovers : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Offers : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Requests : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; Acks : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Naks : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; Declines : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; Releases : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ServerStartTime : DATE_TIME (+28, 8byte)  varptr(st)+28 を基点に操作(8byte:入れ子/配列)
; Scopes : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ScopeInfo : SCOPE_MIB_INFO* (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DATE_TIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global DHCP_MIB_INFO
    #field int Discovers
    #field int Offers
    #field int Requests
    #field int Acks
    #field int Naks
    #field int Declines
    #field int Releases
    #field DATE_TIME ServerStartTime
    #field int Scopes
    #field intptr ScopeInfo
#endstruct

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