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構造体のサイズ。DRT_SETTINGS に対する sizeof パラメーターで指定します。これは、将来のバージョンの DRT API で構造体に新しいフィールドを追加できるようにするためのものです。
cbKeyDWORD4+4+4この DRT インスタンスにおけるキーの正確なバイト数を指定します。現在サポートされているのは 8 バイトのみです。それ以外の値を指定すると、DrtOpen 関数から E_INVALIDARG が返されます。
bProtocolMajorVersionBYTE1+8+8アプリケーションが指定するプロトコルのメジャー バージョンを表すバイト配列へのポインター。これはすべての DRT パケットに埋め込まれ、単一の DRT インスタンスが複数のセキュリティ プロバイダーまたはブートストラップ プロバイダーをサポートしている場合に、使用中のセキュリティ プロバイダーまたはブートストラップ プロバイダーのバージョンを識別するために使用されます。
bProtocolMinorVersionBYTE1+9+9アプリケーションが指定するプロトコルのマイナー バージョンを表すバイト配列へのポインター。 これはすべての DRT パケットに埋め込まれ、単一の DRT インスタンスが複数のセキュリティ プロバイダーまたはブートストラップ プロバイダーをサポートしている場合に、使用中のセキュリティ プロバイダーまたはブートストラップ プロバイダーのバージョンを識別するために使用されます。
ulMaxRoutingAddressesDWORD4+12+12アプリケーションがキーを登録するときに DRT が登録するアドレスの最大数を指定します。このフィールドの最大値は 4 です。
pwzDrtInstancePrefixLPWSTR8/4+16+16この文字列は、DRT インスタンスの名前の基礎となります。インスタンスの名前は、そのインスタンスに関連付けられた Windows パフォーマンス カウンターを特定するために使用できます。
hTransportvoid*8/4+24+20トランスポート作成 API によって作成されたトランスポートへのハンドル。これは、DRT_SETTINGS 構造体で指定されたトランスポートを使用して DRT を開くために使用されます。現在サポートされているのは、DrtCreateIpv6UdpTransport による IPv6 UDP のみです。
pSecurityProviderDRT_SECURITY_PROVIDER*8/4+32+24使用するよう指定されたセキュリティ プロバイダーへのポインター。派生キー セキュリティ プロバイダーのインスタンスは、DrtCreateDerivedKeySecurityProvider を呼び出すことで取得できます。
pBootstrapProviderDRT_BOOTSTRAP_PROVIDER*8/4+40+28使用するよう指定されたブートストラップ プロバイダーへのポインター。PNRP ブートストラップ プロバイダーのインスタンスは、DrtCreatePnrpBootstrapResolver を呼び出すことで取得できます。
eSecurityModeDRT_SECURITY_MODE4+48+32DRT が動作するセキュリティ モードを指定します。DRT メッシュに参加するすべてのノードは、同じセキュリティ モードを使用しなければなりません。

公式ドキュメント

DRT_SETTINGS 構造体には、ローカルの分散ルーティング テーブル (Distributed Routing Table) で使用される設定が格納されます。

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

各言語での定義

#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