ホーム › NetworkManagement.Dhcp › DHCP_OPTION_DATA_ELEMENT

DHCP_OPTION_DATA_ELEMENT

構造体

サイズx64: 24 バイト / x86: 12 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
OptionType	DHCP_OPTION_DATA_TYPE	4	+0	+0	後続の Element フィールドに格納されるデータの型を示す DHCP_OPTION_DATA_TYPE 列挙型の値です。
Element	DHCP_OPTION_ELEMENT_UNION	16/8	+8	+4	OptionTypeに応じた値を保持する共用体。バイト/ワード/文字列等を格納する。

共用体: DHCP_OPTION_ELEMENT_UNION x64 16B / x86 8B

フィールド	型	サイズ	x64	x86	説明
ByteOption	BYTE	1	+0	+0	データを BYTE 値として指定します。このフィールドは OptionType が DhcpByteOption の場合に存在します。
WordOption	WORD	2	+0	+0	データを WORD 値として指定します。このフィールドは OptionType が DhcpWordOption の場合に存在します。
DWordOption	DWORD	4	+0	+0	データを DWORD 値として指定します。このフィールドは OptionType が DhcpDWordOption の場合に存在します。
DWordDWordOption	DWORD_DWORD	8	+0	+0	データを DWORD_DWORD 値として指定します。このフィールドは OptionType が DhcpDWordDWordOption の場合に存在します。
IpAddressOption	DWORD	4	+0	+0	データを DHCP_IP_ADDRESS (DWORD) 値として指定します。このフィールドは OptionType が IpAddressOption の場合に存在します。
StringDataOption	LPWSTR	8/4	+0	+0	データを Unicode 文字列値として指定します。このフィールドは OptionType が DhcpStringDataOption の場合に存在します。
BinaryDataOption	DHCP_BINARY_DATA	16/8	+0	+0	データを DHCP_BINARY_DATA 構造体として指定します。このフィールドは OptionType が DhcpBinaryDataOption の場合に存在します。
EncapsulatedDataOption	DHCP_BINARY_DATA	16/8	+0	+0	データを DHCP_BINARY_DATA 構造体にカプセル化された形式で指定します。アプリケーションは、DHCP_BINARY_DATA の Data フィールドからこの不透明なデータカプセルを読み取るために、その形式を把握している必要があります。このフィールドは OptionType が DhcpEncapsulatedDataOption の場合に存在します。
Ipv6AddressDataOption	LPWSTR	8/4	+0	+0	データを Unicode 文字列値として指定します。このフィールドは OptionType が DhcpIpv6AddressOption の場合に存在します。

公式ドキュメント

DHCP_OPTION_DATA_ELEMENT 構造体は、DHCP_OPTION_DATA 構造体内に (単独で、または配列のメンバーとして) 存在するデータ要素を定義します。

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

各言語での定義

#include <windows.h>

// DHCP_OPTION_DATA_ELEMENT  (x64 24 / x86 12 バイト)
typedef struct DHCP_OPTION_DATA_ELEMENT {
    DHCP_OPTION_DATA_TYPE OptionType;
    DHCP_OPTION_ELEMENT_UNION Element;
} DHCP_OPTION_DATA_ELEMENT;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DHCP_OPTION_DATA_ELEMENT
{
    public int OptionType;
    public DHCP_OPTION_ELEMENT_UNION Element;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DHCP_OPTION_DATA_ELEMENT
    Public OptionType As Integer
    Public Element As DHCP_OPTION_ELEMENT_UNION
End Structure

import ctypes
from ctypes import wintypes

class DHCP_OPTION_DATA_ELEMENT(ctypes.Structure):
    _fields_ = [
        ("OptionType", ctypes.c_int),
        ("Element", DHCP_OPTION_ELEMENT_UNION),
    ]

#[repr(C)]
pub struct DHCP_OPTION_DATA_ELEMENT {
    pub OptionType: i32,
    pub Element: DHCP_OPTION_ELEMENT_UNION,
}

import "golang.org/x/sys/windows"

type DHCP_OPTION_DATA_ELEMENT struct {
	OptionType int32
	Element DHCP_OPTION_ELEMENT_UNION
}

type
  DHCP_OPTION_DATA_ELEMENT = record
    OptionType: Integer;
    Element: DHCP_OPTION_ELEMENT_UNION;
  end;

const DHCP_OPTION_DATA_ELEMENT = extern struct {
    OptionType: i32,
    Element: DHCP_OPTION_ELEMENT_UNION,
};

type
  DHCP_OPTION_DATA_ELEMENT {.bycopy.} = object
    OptionType: int32
    Element: DHCP_OPTION_ELEMENT_UNION

struct DHCP_OPTION_DATA_ELEMENT
{
    int OptionType;
    DHCP_OPTION_ELEMENT_UNION Element;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DHCP_OPTION_DATA_ELEMENT サイズ: 12 バイト(x86)
dim st, 3    ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; OptionType : DHCP_OPTION_DATA_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Element : DHCP_OPTION_ELEMENT_UNION (+4, 8byte)  varptr(st)+4 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DHCP_OPTION_DATA_ELEMENT サイズ: 24 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; OptionType : DHCP_OPTION_DATA_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Element : DHCP_OPTION_ELEMENT_UNION (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DHCP_OPTION_DATA_ELEMENT
    #field int OptionType
    #field byte Element 16
#endstruct

stdim st, DHCP_OPTION_DATA_ELEMENT        ; NSTRUCT 変数を確保
st->OptionType = 100
mes "OptionType=" + st->OptionType
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。