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

DRT_SETTINGS

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

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のサイズをバイト単位で示す値。
cbKeyDWORD4+4+4DRTで使用するキーのバイト長。
bProtocolMajorVersionBYTE1+8+8DRTプロトコルのメジャーバージョン番号。
bProtocolMinorVersionBYTE1+9+9DRTプロトコルのマイナーバージョン番号。
ulMaxRoutingAddressesDWORD4+12+12ルーティングに使用する最大アドレス数。
pwzDrtInstancePrefixLPWSTR8/4+16+16DRTインスタンスのプレフィックスを表すワイド文字列。NULL可。
hTransportvoid*8/4+24+20DRTが使用するトランスポートのハンドル。
pSecurityProviderDRT_SECURITY_PROVIDER*8/4+32+24使用するセキュリティプロバイダを示すDRT_SECURITY_PROVIDERへのポインタ。
pBootstrapProviderDRT_BOOTSTRAP_PROVIDER*8/4+40+28使用するブートストラッププロバイダを示すDRT_BOOTSTRAP_PROVIDERへのポインタ。
eSecurityModeDRT_SECURITY_MODE4+48+32DRTのセキュリティモードを示すDRT_SECURITY_MODE列挙値。

各言語での定義

#include <windows.h>

// DRT_SETTINGS  (x64 56 / x86 36 バイト)
typedef struct DRT_SETTINGS {
    DWORD dwSize;
    DWORD cbKey;
    BYTE bProtocolMajorVersion;
    BYTE bProtocolMinorVersion;
    DWORD ulMaxRoutingAddresses;
    LPWSTR pwzDrtInstancePrefix;
    void* hTransport;
    DRT_SECURITY_PROVIDER* pSecurityProvider;
    DRT_BOOTSTRAP_PROVIDER* pBootstrapProvider;
    DRT_SECURITY_MODE eSecurityMode;
} DRT_SETTINGS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DRT_SETTINGS
{
    public uint dwSize;
    public uint cbKey;
    public byte bProtocolMajorVersion;
    public byte bProtocolMinorVersion;
    public uint ulMaxRoutingAddresses;
    public IntPtr pwzDrtInstancePrefix;
    public IntPtr hTransport;
    public IntPtr pSecurityProvider;
    public IntPtr pBootstrapProvider;
    public int eSecurityMode;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DRT_SETTINGS
    Public dwSize As UInteger
    Public cbKey As UInteger
    Public bProtocolMajorVersion As Byte
    Public bProtocolMinorVersion As Byte
    Public ulMaxRoutingAddresses As UInteger
    Public pwzDrtInstancePrefix As IntPtr
    Public hTransport As IntPtr
    Public pSecurityProvider As IntPtr
    Public pBootstrapProvider As IntPtr
    Public eSecurityMode As Integer
End Structure
import ctypes
from ctypes import wintypes

class DRT_SETTINGS(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("cbKey", wintypes.DWORD),
        ("bProtocolMajorVersion", ctypes.c_ubyte),
        ("bProtocolMinorVersion", ctypes.c_ubyte),
        ("ulMaxRoutingAddresses", wintypes.DWORD),
        ("pwzDrtInstancePrefix", ctypes.c_void_p),
        ("hTransport", ctypes.c_void_p),
        ("pSecurityProvider", ctypes.c_void_p),
        ("pBootstrapProvider", ctypes.c_void_p),
        ("eSecurityMode", ctypes.c_int),
    ]
#[repr(C)]
pub struct DRT_SETTINGS {
    pub dwSize: u32,
    pub cbKey: u32,
    pub bProtocolMajorVersion: u8,
    pub bProtocolMinorVersion: u8,
    pub ulMaxRoutingAddresses: u32,
    pub pwzDrtInstancePrefix: *mut core::ffi::c_void,
    pub hTransport: *mut core::ffi::c_void,
    pub pSecurityProvider: *mut core::ffi::c_void,
    pub pBootstrapProvider: *mut core::ffi::c_void,
    pub eSecurityMode: i32,
}
import "golang.org/x/sys/windows"

type DRT_SETTINGS struct {
	dwSize uint32
	cbKey uint32
	bProtocolMajorVersion byte
	bProtocolMinorVersion byte
	ulMaxRoutingAddresses uint32
	pwzDrtInstancePrefix uintptr
	hTransport uintptr
	pSecurityProvider uintptr
	pBootstrapProvider uintptr
	eSecurityMode int32
}
type
  DRT_SETTINGS = record
    dwSize: DWORD;
    cbKey: DWORD;
    bProtocolMajorVersion: Byte;
    bProtocolMinorVersion: Byte;
    ulMaxRoutingAddresses: DWORD;
    pwzDrtInstancePrefix: Pointer;
    hTransport: Pointer;
    pSecurityProvider: Pointer;
    pBootstrapProvider: Pointer;
    eSecurityMode: Integer;
  end;
const DRT_SETTINGS = extern struct {
    dwSize: u32,
    cbKey: u32,
    bProtocolMajorVersion: u8,
    bProtocolMinorVersion: u8,
    ulMaxRoutingAddresses: u32,
    pwzDrtInstancePrefix: ?*anyopaque,
    hTransport: ?*anyopaque,
    pSecurityProvider: ?*anyopaque,
    pBootstrapProvider: ?*anyopaque,
    eSecurityMode: i32,
};
type
  DRT_SETTINGS {.bycopy.} = object
    dwSize: uint32
    cbKey: uint32
    bProtocolMajorVersion: uint8
    bProtocolMinorVersion: uint8
    ulMaxRoutingAddresses: uint32
    pwzDrtInstancePrefix: pointer
    hTransport: pointer
    pSecurityProvider: pointer
    pBootstrapProvider: pointer
    eSecurityMode: int32
struct DRT_SETTINGS
{
    uint dwSize;
    uint cbKey;
    ubyte bProtocolMajorVersion;
    ubyte bProtocolMinorVersion;
    uint ulMaxRoutingAddresses;
    void* pwzDrtInstancePrefix;
    void* hTransport;
    void* pSecurityProvider;
    void* pBootstrapProvider;
    int eSecurityMode;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DRT_SETTINGS サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; cbKey : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; bProtocolMajorVersion : BYTE (+8, 1byte)  poke st,8,値  /  値 = peek(st,8)
; bProtocolMinorVersion : BYTE (+9, 1byte)  poke st,9,値  /  値 = peek(st,9)
; ulMaxRoutingAddresses : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pwzDrtInstancePrefix : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; hTransport : void* (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; pSecurityProvider : DRT_SECURITY_PROVIDER* (+24, 4byte)  varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; pBootstrapProvider : DRT_BOOTSTRAP_PROVIDER* (+28, 4byte)  varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; eSecurityMode : DRT_SECURITY_MODE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DRT_SETTINGS サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; cbKey : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; bProtocolMajorVersion : BYTE (+8, 1byte)  poke st,8,値  /  値 = peek(st,8)
; bProtocolMinorVersion : BYTE (+9, 1byte)  poke st,9,値  /  値 = peek(st,9)
; ulMaxRoutingAddresses : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pwzDrtInstancePrefix : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; hTransport : void* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; pSecurityProvider : DRT_SECURITY_PROVIDER* (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; pBootstrapProvider : DRT_BOOTSTRAP_PROVIDER* (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; eSecurityMode : DRT_SECURITY_MODE (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DRT_SETTINGS
    #field int dwSize
    #field int cbKey
    #field byte bProtocolMajorVersion
    #field byte bProtocolMinorVersion
    #field int ulMaxRoutingAddresses
    #field intptr pwzDrtInstancePrefix
    #field intptr hTransport
    #field intptr pSecurityProvider
    #field intptr pBootstrapProvider
    #field int eSecurityMode
#endstruct

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