ホーム › NetworkManagement.P2P › PNRPINFO_V2
PNRPINFO_V2
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||
|---|---|---|---|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | この構造体のサイズを指定します。 | ||||
| lpwszIdentity | LPWSTR | 8/4 | +8 | +4 | 識別情報を格納する Unicode 文字列を指し示します。 | ||||
| nMaxResolve | DWORD | 4 | +16 | +8 | 要求する名前解決の数を指定します。 | ||||
| dwTimeout | DWORD | 4 | +20 | +12 | 応答を待機する時間を秒単位で指定します。 | ||||
| dwLifetime | DWORD | 4 | +24 | +16 | 更新操作の間隔を秒数で指定します。86400 (24 * 60 * 60 秒) でなければなりません。 | ||||
| enResolveCriteria | PNRP_RESOLVE_CRITERIA | 4 | +28 | +20 | 一致するものを解決する際に使用する条件を指定します。PNRP は、最初に一致した名前を探すことも、サービスの場所に数値的に近い名前を見つけようとすることもできます。有効な値は PNRP_RESOLVE_CRITERIA で指定されています。 | ||||
| dwFlags | DWORD | 4 | +32 | +24 | 解決操作に使用するフラグを指定します。有効な値は次のとおりです。
| ||||
| saHint | SOCKET_ADDRESS | 16/8 | +40 | +28 | 場所として使用する IPv6 アドレスを指定します。dwFlags メンバーは PNRPINFO_HINT でなければなりません。 | ||||
| enNameState | PNRP_REGISTERED_ID_STATE | 4 | +56 | +36 | 登録された ID の状態を指定します。この値は予約済みであり、0 (ゼロ) に設定しなければなりません。 | ||||
| enExtendedPayloadType | PNRP_EXTENDED_PAYLOAD_TYPE | 4 | +60 | +40 | 拡張ペイロードの型を示すPNRP_EXTENDED_PAYLOAD_TYPE列挙値。 | ||||
| Anonymous | _Anonymous_e__Union | 16/8 | +64 | +44 | 拡張ペイロードのデータ(バイナリまたは文字列)を保持する共用体。 |
共用体: _Anonymous_e__Union x64 16B / x86 8B
| フィールド | 型 | サイズ | x64 | x86 |
|---|---|---|---|---|
| blobPayload | BLOB | 16/8 | +0 | +0 |
| pwszPayload | LPWSTR | 8/4 | +0 | +0 |
公式ドキュメント
PNRPINFO_V1 構造体は、WSAQUERYSET 構造体の lpBlob メンバーから指し示されます。
解説(Remarks)
Windows Vista 以降では、PNRPINFO_V2 構造体を使用してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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>
// SOCKET_ADDRESS (x64 16 / x86 8 バイト)
typedef struct SOCKET_ADDRESS {
SOCKADDR* lpSockaddr;
INT iSockaddrLength;
} SOCKET_ADDRESS;
// PNRPINFO_V2 (x64 80 / x86 52 バイト)
typedef struct PNRPINFO_V2 {
DWORD dwSize;
LPWSTR lpwszIdentity;
DWORD nMaxResolve;
DWORD dwTimeout;
DWORD dwLifetime;
PNRP_RESOLVE_CRITERIA enResolveCriteria;
DWORD dwFlags;
SOCKET_ADDRESS saHint;
PNRP_REGISTERED_ID_STATE enNameState;
PNRP_EXTENDED_PAYLOAD_TYPE enExtendedPayloadType;
_Anonymous_e__Union Anonymous;
} PNRPINFO_V2;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_V2
{
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;
public int enExtendedPayloadType;
public _Anonymous_e__Union Anonymous;
}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_V2
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
Public enExtendedPayloadType As Integer
Public Anonymous As _Anonymous_e__Union
End Structureimport ctypes
from ctypes import wintypes
class SOCKET_ADDRESS(ctypes.Structure):
_fields_ = [
("lpSockaddr", ctypes.c_void_p),
("iSockaddrLength", ctypes.c_int),
]
class PNRPINFO_V2(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),
("enExtendedPayloadType", ctypes.c_int),
("Anonymous", _Anonymous_e__Union),
]#[repr(C)]
pub struct SOCKET_ADDRESS {
pub lpSockaddr: *mut core::ffi::c_void,
pub iSockaddrLength: i32,
}
#[repr(C)]
pub struct PNRPINFO_V2 {
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,
pub enExtendedPayloadType: i32,
pub Anonymous: _Anonymous_e__Union,
}import "golang.org/x/sys/windows"
type SOCKET_ADDRESS struct {
lpSockaddr uintptr
iSockaddrLength int32
}
type PNRPINFO_V2 struct {
dwSize uint32
lpwszIdentity uintptr
nMaxResolve uint32
dwTimeout uint32
dwLifetime uint32
enResolveCriteria int32
dwFlags uint32
saHint SOCKET_ADDRESS
enNameState int32
enExtendedPayloadType int32
Anonymous _Anonymous_e__Union
}type
SOCKET_ADDRESS = record
lpSockaddr: Pointer;
iSockaddrLength: Integer;
end;
PNRPINFO_V2 = record
dwSize: DWORD;
lpwszIdentity: Pointer;
nMaxResolve: DWORD;
dwTimeout: DWORD;
dwLifetime: DWORD;
enResolveCriteria: Integer;
dwFlags: DWORD;
saHint: SOCKET_ADDRESS;
enNameState: Integer;
enExtendedPayloadType: Integer;
Anonymous: _Anonymous_e__Union;
end;const SOCKET_ADDRESS = extern struct {
lpSockaddr: ?*anyopaque,
iSockaddrLength: i32,
};
const PNRPINFO_V2 = extern struct {
dwSize: u32,
lpwszIdentity: ?*anyopaque,
nMaxResolve: u32,
dwTimeout: u32,
dwLifetime: u32,
enResolveCriteria: i32,
dwFlags: u32,
saHint: SOCKET_ADDRESS,
enNameState: i32,
enExtendedPayloadType: i32,
Anonymous: _Anonymous_e__Union,
};type
SOCKET_ADDRESS {.bycopy.} = object
lpSockaddr: pointer
iSockaddrLength: int32
PNRPINFO_V2 {.bycopy.} = object
dwSize: uint32
lpwszIdentity: pointer
nMaxResolve: uint32
dwTimeout: uint32
dwLifetime: uint32
enResolveCriteria: int32
dwFlags: uint32
saHint: SOCKET_ADDRESS
enNameState: int32
enExtendedPayloadType: int32
Anonymous: _Anonymous_e__Unionstruct SOCKET_ADDRESS
{
void* lpSockaddr;
int iSockaddrLength;
}
struct PNRPINFO_V2
{
uint dwSize;
void* lpwszIdentity;
uint nMaxResolve;
uint dwTimeout;
uint dwLifetime;
int enResolveCriteria;
uint dwFlags;
SOCKET_ADDRESS saHint;
int enNameState;
int enExtendedPayloadType;
_Anonymous_e__Union Anonymous;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PNRPINFO_V2 サイズ: 52 バイト(x86)
dim st, 13 ; 4byte整数×13(構造体サイズ 52 / 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 も可)
; enExtendedPayloadType : PNRP_EXTENDED_PAYLOAD_TYPE (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+44, 8byte) varptr(st)+44 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PNRPINFO_V2 サイズ: 80 バイト(x64)
dim st, 20 ; 4byte整数×20(構造体サイズ 80 / 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 も可)
; enExtendedPayloadType : PNRP_EXTENDED_PAYLOAD_TYPE (+60, 4byte) st.15 = 値 / 値 = st.15 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+64, 16byte) varptr(st)+64 を基点に操作(16byte:入れ子/配列)
; ※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_V2
#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
#field int enExtendedPayloadType
#field byte Anonymous 16
#endstruct
stdim st, PNRPINFO_V2 ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。