ホーム › NetworkManagement.P2P › DRT_SETTINGS
DRT_SETTINGS
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | 構造体のサイズ。DRT_SETTINGS に対する sizeof パラメーターで指定します。これは、将来のバージョンの DRT API で構造体に新しいフィールドを追加できるようにするためのものです。 |
| cbKey | DWORD | 4 | +4 | +4 | この DRT インスタンスにおけるキーの正確なバイト数を指定します。現在サポートされているのは 8 バイトのみです。それ以外の値を指定すると、DrtOpen 関数から E_INVALIDARG が返されます。 |
| bProtocolMajorVersion | BYTE | 1 | +8 | +8 | アプリケーションが指定するプロトコルのメジャー バージョンを表すバイト配列へのポインター。これはすべての DRT パケットに埋め込まれ、単一の DRT インスタンスが複数のセキュリティ プロバイダーまたはブートストラップ プロバイダーをサポートしている場合に、使用中のセキュリティ プロバイダーまたはブートストラップ プロバイダーのバージョンを識別するために使用されます。 |
| bProtocolMinorVersion | BYTE | 1 | +9 | +9 | アプリケーションが指定するプロトコルのマイナー バージョンを表すバイト配列へのポインター。 これはすべての DRT パケットに埋め込まれ、単一の DRT インスタンスが複数のセキュリティ プロバイダーまたはブートストラップ プロバイダーをサポートしている場合に、使用中のセキュリティ プロバイダーまたはブートストラップ プロバイダーのバージョンを識別するために使用されます。 |
| ulMaxRoutingAddresses | DWORD | 4 | +12 | +12 | アプリケーションがキーを登録するときに DRT が登録するアドレスの最大数を指定します。このフィールドの最大値は 4 です。 |
| pwzDrtInstancePrefix | LPWSTR | 8/4 | +16 | +16 | この文字列は、DRT インスタンスの名前の基礎となります。インスタンスの名前は、そのインスタンスに関連付けられた Windows パフォーマンス カウンターを特定するために使用できます。 |
| hTransport | void* | 8/4 | +24 | +20 | トランスポート作成 API によって作成されたトランスポートへのハンドル。これは、DRT_SETTINGS 構造体で指定されたトランスポートを使用して DRT を開くために使用されます。現在サポートされているのは、DrtCreateIpv6UdpTransport による IPv6 UDP のみです。 |
| pSecurityProvider | DRT_SECURITY_PROVIDER* | 8/4 | +32 | +24 | 使用するよう指定されたセキュリティ プロバイダーへのポインター。派生キー セキュリティ プロバイダーのインスタンスは、DrtCreateDerivedKeySecurityProvider を呼び出すことで取得できます。 |
| pBootstrapProvider | DRT_BOOTSTRAP_PROVIDER* | 8/4 | +40 | +28 | 使用するよう指定されたブートストラップ プロバイダーへのポインター。PNRP ブートストラップ プロバイダーのインスタンスは、DrtCreatePnrpBootstrapResolver を呼び出すことで取得できます。 |
| eSecurityMode | DRT_SECURITY_MODE | 4 | +48 | +32 | DRT が動作するセキュリティ モードを指定します。DRT メッシュに参加するすべてのノードは、同じセキュリティ モードを使用しなければなりません。 |
公式ドキュメント
DRT_SETTINGS 構造体には、ローカルの分散ルーティング テーブル (Distributed Routing Table) で使用される設定が格納されます。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
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 Structureimport 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: int32struct 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