Win32 API 日本語リファレンス
ホーム › System.HostComputeNetwork › HCN_PORT_RANGE_ENTRY

HCN_PORT_RANGE_ENTRY

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

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

フィールド

フィールド型サイズx64x86説明
OwningPartitionIdGUID16+0+0ポート範囲を所有するパーティションのGUID。
TargetPartitionIdGUID16+16+16対象とするパーティションのGUID。
ProtocolHCN_PORT_PROTOCOL4+32+32対象プロトコル(HCN_PORT_PROTOCOL、TCP/UDP等)。
PriorityULONGLONG8+40+40予約の優先度。
ReservationTypeDWORD4+48+48予約の種類を示すフラグ。
SharingFlagsDWORD4+52+52ポート共有に関するフラグ。
DeliveryModeDWORD4+56+56パケット配信モードを示すフラグ。
StartingPortWORD2+60+60予約するポート範囲の開始ポート番号。
EndingPortWORD2+62+62予約するポート範囲の終了ポート番号。

各言語での定義

#include <windows.h>

// HCN_PORT_RANGE_ENTRY  (x64 64 / x86 64 バイト)
typedef struct HCN_PORT_RANGE_ENTRY {
    GUID OwningPartitionId;
    GUID TargetPartitionId;
    HCN_PORT_PROTOCOL Protocol;
    ULONGLONG Priority;
    DWORD ReservationType;
    DWORD SharingFlags;
    DWORD DeliveryMode;
    WORD StartingPort;
    WORD EndingPort;
} HCN_PORT_RANGE_ENTRY;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HCN_PORT_RANGE_ENTRY
{
    public Guid OwningPartitionId;
    public Guid TargetPartitionId;
    public int Protocol;
    public ulong Priority;
    public uint ReservationType;
    public uint SharingFlags;
    public uint DeliveryMode;
    public ushort StartingPort;
    public ushort EndingPort;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HCN_PORT_RANGE_ENTRY
    Public OwningPartitionId As Guid
    Public TargetPartitionId As Guid
    Public Protocol As Integer
    Public Priority As ULong
    Public ReservationType As UInteger
    Public SharingFlags As UInteger
    Public DeliveryMode As UInteger
    Public StartingPort As UShort
    Public EndingPort As UShort
End Structure
import ctypes
from ctypes import wintypes

class HCN_PORT_RANGE_ENTRY(ctypes.Structure):
    _fields_ = [
        ("OwningPartitionId", GUID),
        ("TargetPartitionId", GUID),
        ("Protocol", ctypes.c_int),
        ("Priority", ctypes.c_ulonglong),
        ("ReservationType", wintypes.DWORD),
        ("SharingFlags", wintypes.DWORD),
        ("DeliveryMode", wintypes.DWORD),
        ("StartingPort", ctypes.c_ushort),
        ("EndingPort", ctypes.c_ushort),
    ]
#[repr(C)]
pub struct HCN_PORT_RANGE_ENTRY {
    pub OwningPartitionId: GUID,
    pub TargetPartitionId: GUID,
    pub Protocol: i32,
    pub Priority: u64,
    pub ReservationType: u32,
    pub SharingFlags: u32,
    pub DeliveryMode: u32,
    pub StartingPort: u16,
    pub EndingPort: u16,
}
import "golang.org/x/sys/windows"

type HCN_PORT_RANGE_ENTRY struct {
	OwningPartitionId windows.GUID
	TargetPartitionId windows.GUID
	Protocol int32
	Priority uint64
	ReservationType uint32
	SharingFlags uint32
	DeliveryMode uint32
	StartingPort uint16
	EndingPort uint16
}
type
  HCN_PORT_RANGE_ENTRY = record
    OwningPartitionId: TGUID;
    TargetPartitionId: TGUID;
    Protocol: Integer;
    Priority: UInt64;
    ReservationType: DWORD;
    SharingFlags: DWORD;
    DeliveryMode: DWORD;
    StartingPort: Word;
    EndingPort: Word;
  end;
const HCN_PORT_RANGE_ENTRY = extern struct {
    OwningPartitionId: GUID,
    TargetPartitionId: GUID,
    Protocol: i32,
    Priority: u64,
    ReservationType: u32,
    SharingFlags: u32,
    DeliveryMode: u32,
    StartingPort: u16,
    EndingPort: u16,
};
type
  HCN_PORT_RANGE_ENTRY {.bycopy.} = object
    OwningPartitionId: GUID
    TargetPartitionId: GUID
    Protocol: int32
    Priority: uint64
    ReservationType: uint32
    SharingFlags: uint32
    DeliveryMode: uint32
    StartingPort: uint16
    EndingPort: uint16
struct HCN_PORT_RANGE_ENTRY
{
    GUID OwningPartitionId;
    GUID TargetPartitionId;
    int Protocol;
    ulong Priority;
    uint ReservationType;
    uint SharingFlags;
    uint DeliveryMode;
    ushort StartingPort;
    ushort EndingPort;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; HCN_PORT_RANGE_ENTRY サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; OwningPartitionId : GUID (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; TargetPartitionId : GUID (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; Protocol : HCN_PORT_PROTOCOL (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; Priority : ULONGLONG (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ReservationType : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; SharingFlags : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; DeliveryMode : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; StartingPort : WORD (+60, 2byte)  wpoke st,60,値  /  値 = wpeek(st,60)
; EndingPort : WORD (+62, 2byte)  wpoke st,62,値  /  値 = wpeek(st,62)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global HCN_PORT_RANGE_ENTRY
    #field GUID OwningPartitionId
    #field GUID TargetPartitionId
    #field int Protocol
    #field int64 Priority
    #field int ReservationType
    #field int SharingFlags
    #field int DeliveryMode
    #field short StartingPort
    #field short EndingPort
#endstruct

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