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

PNRPINFO_V1

構造体
サイズx64: 64 バイト / x86: 40 バイト

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のサイズをバイト単位で示す値。
lpwszIdentityLPWSTR8/4+8+4登録に使用するIDを表すNULL終端ワイド文字列。NULL可。
nMaxResolveDWORD4+16+8解決時に返す最大エンドポイント数。
dwTimeoutDWORD4+20+12解決処理のタイムアウト時間を秒単位で示す値。
dwLifetimeDWORD4+24+16登録の有効期間を秒単位で示す値。
enResolveCriteriaPNRP_RESOLVE_CRITERIA4+28+20名前解決の判定基準を示すPNRP_RESOLVE_CRITERIA列挙値。
dwFlagsDWORD4+32+24解決や登録の動作を制御するフラグ。
saHintSOCKET_ADDRESS16/8+40+28解決のヒントとなるソケットアドレス(SOCKET_ADDRESS)。
enNameStatePNRP_REGISTERED_ID_STATE4+56+36登録済みID(名前)の状態を示すPNRP_REGISTERED_ID_STATE列挙値。

各言語での定義

#include <windows.h>

// SOCKET_ADDRESS  (x64 16 / x86 8 バイト)
typedef struct SOCKET_ADDRESS {
    SOCKADDR* lpSockaddr;
    INT iSockaddrLength;
} SOCKET_ADDRESS;

// PNRPINFO_V1  (x64 64 / x86 40 バイト)
typedef struct PNRPINFO_V1 {
    DWORD dwSize;
    LPWSTR lpwszIdentity;
    DWORD nMaxResolve;
    DWORD dwTimeout;
    DWORD dwLifetime;
    PNRP_RESOLVE_CRITERIA enResolveCriteria;
    DWORD dwFlags;
    SOCKET_ADDRESS saHint;
    PNRP_REGISTERED_ID_STATE enNameState;
} PNRPINFO_V1;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SOCKET_ADDRESS
{
    public IntPtr lpSockaddr;
    public int iSockaddrLength;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PNRPINFO_V1
{
    public uint dwSize;
    public IntPtr lpwszIdentity;
    public uint nMaxResolve;
    public uint dwTimeout;
    public uint dwLifetime;
    public int enResolveCriteria;
    public uint dwFlags;
    public SOCKET_ADDRESS saHint;
    public int enNameState;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SOCKET_ADDRESS
    Public lpSockaddr As IntPtr
    Public iSockaddrLength As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PNRPINFO_V1
    Public dwSize As UInteger
    Public lpwszIdentity As IntPtr
    Public nMaxResolve As UInteger
    Public dwTimeout As UInteger
    Public dwLifetime As UInteger
    Public enResolveCriteria As Integer
    Public dwFlags As UInteger
    Public saHint As SOCKET_ADDRESS
    Public enNameState As Integer
End Structure
import ctypes
from ctypes import wintypes

class SOCKET_ADDRESS(ctypes.Structure):
    _fields_ = [
        ("lpSockaddr", ctypes.c_void_p),
        ("iSockaddrLength", ctypes.c_int),
    ]

class PNRPINFO_V1(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("lpwszIdentity", ctypes.c_void_p),
        ("nMaxResolve", wintypes.DWORD),
        ("dwTimeout", wintypes.DWORD),
        ("dwLifetime", wintypes.DWORD),
        ("enResolveCriteria", ctypes.c_int),
        ("dwFlags", wintypes.DWORD),
        ("saHint", SOCKET_ADDRESS),
        ("enNameState", ctypes.c_int),
    ]
#[repr(C)]
pub struct SOCKET_ADDRESS {
    pub lpSockaddr: *mut core::ffi::c_void,
    pub iSockaddrLength: i32,
}

#[repr(C)]
pub struct PNRPINFO_V1 {
    pub dwSize: u32,
    pub lpwszIdentity: *mut core::ffi::c_void,
    pub nMaxResolve: u32,
    pub dwTimeout: u32,
    pub dwLifetime: u32,
    pub enResolveCriteria: i32,
    pub dwFlags: u32,
    pub saHint: SOCKET_ADDRESS,
    pub enNameState: i32,
}
import "golang.org/x/sys/windows"

type SOCKET_ADDRESS struct {
	lpSockaddr uintptr
	iSockaddrLength int32
}

type PNRPINFO_V1 struct {
	dwSize uint32
	lpwszIdentity uintptr
	nMaxResolve uint32
	dwTimeout uint32
	dwLifetime uint32
	enResolveCriteria int32
	dwFlags uint32
	saHint SOCKET_ADDRESS
	enNameState int32
}
type
  SOCKET_ADDRESS = record
    lpSockaddr: Pointer;
    iSockaddrLength: Integer;
  end;

  PNRPINFO_V1 = record
    dwSize: DWORD;
    lpwszIdentity: Pointer;
    nMaxResolve: DWORD;
    dwTimeout: DWORD;
    dwLifetime: DWORD;
    enResolveCriteria: Integer;
    dwFlags: DWORD;
    saHint: SOCKET_ADDRESS;
    enNameState: Integer;
  end;
const SOCKET_ADDRESS = extern struct {
    lpSockaddr: ?*anyopaque,
    iSockaddrLength: i32,
};

const PNRPINFO_V1 = extern struct {
    dwSize: u32,
    lpwszIdentity: ?*anyopaque,
    nMaxResolve: u32,
    dwTimeout: u32,
    dwLifetime: u32,
    enResolveCriteria: i32,
    dwFlags: u32,
    saHint: SOCKET_ADDRESS,
    enNameState: i32,
};
type
  SOCKET_ADDRESS {.bycopy.} = object
    lpSockaddr: pointer
    iSockaddrLength: int32

  PNRPINFO_V1 {.bycopy.} = object
    dwSize: uint32
    lpwszIdentity: pointer
    nMaxResolve: uint32
    dwTimeout: uint32
    dwLifetime: uint32
    enResolveCriteria: int32
    dwFlags: uint32
    saHint: SOCKET_ADDRESS
    enNameState: int32
struct SOCKET_ADDRESS
{
    void* lpSockaddr;
    int iSockaddrLength;
}

struct PNRPINFO_V1
{
    uint dwSize;
    void* lpwszIdentity;
    uint nMaxResolve;
    uint dwTimeout;
    uint dwLifetime;
    int enResolveCriteria;
    uint dwFlags;
    SOCKET_ADDRESS saHint;
    int enNameState;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PNRPINFO_V1 サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; lpwszIdentity : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; nMaxResolve : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwTimeout : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwLifetime : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; enResolveCriteria : PNRP_RESOLVE_CRITERIA (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwFlags : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; saHint : SOCKET_ADDRESS (+28, 8byte)  varptr(st)+28 を基点に操作(8byte:入れ子/配列)
; enNameState : PNRP_REGISTERED_ID_STATE (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PNRPINFO_V1 サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; lpwszIdentity : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; nMaxResolve : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwTimeout : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwLifetime : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; enResolveCriteria : PNRP_RESOLVE_CRITERIA (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwFlags : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; saHint : SOCKET_ADDRESS (+40, 16byte)  varptr(st)+40 を基点に操作(16byte:入れ子/配列)
; enNameState : PNRP_REGISTERED_ID_STATE (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global SOCKET_ADDRESS
    #field intptr lpSockaddr
    #field int iSockaddrLength
#endstruct

#defstruct global PNRPINFO_V1
    #field int dwSize
    #field intptr lpwszIdentity
    #field int nMaxResolve
    #field int dwTimeout
    #field int dwLifetime
    #field int enResolveCriteria
    #field int dwFlags
    #field SOCKET_ADDRESS saHint
    #field int enNameState
#endstruct

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