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

PEER_MEMBER

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

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のサイズをバイト単位で指定します。
dwFlagsDWORD4+4+4

メンバーの状態を指定する PEER_MEMBER_FLAGS 列挙型の値です。

意味
PEER_MEMBER_PRESENT
メンバーはピアグループ内に存在します。
pwzIdentityLPWSTR8/4+8+8メンバーのピア名を指定する Unicode 文字列へのポインターです。
pwzAttributesLPWSTR8/4+16+12メンバーの属性を指定する Unicode 文字列へのポインターです。この文字列の形式はアプリケーションによって定義されます。
ullNodeIdULONGLONG8+24+16ノード ID を格納する符号なし 64 ビット整数です。同じピアが複数のノード ID を持つことがあり、それぞれが異なるピアグループに参加する別のノードを識別します。
cAddressesDWORD4+32+24pAddress に列挙されている IP アドレスの数を指定します。
pAddressesPEER_ADDRESS*8/4+40+28メンバーが使用する PEER_ADDRESS 構造体のリストへのポインターです。
pCredentialInfoPEER_CREDENTIAL_INFO*8/4+48+32メンバーのセキュリティ資格情報に関する情報を格納する PEER_CREDENTIAL_INFO 構造体へのポインターです。

公式ドキュメント

PEER_MEMBER 構造体には、ピアグループのメンバーを説明する情報が格納されます。

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

各言語での定義

#include <windows.h>

// PEER_MEMBER  (x64 56 / x86 40 バイト)
typedef struct PEER_MEMBER {
    DWORD dwSize;
    DWORD dwFlags;
    LPWSTR pwzIdentity;
    LPWSTR pwzAttributes;
    ULONGLONG ullNodeId;
    DWORD cAddresses;
    PEER_ADDRESS* pAddresses;
    PEER_CREDENTIAL_INFO* pCredentialInfo;
} PEER_MEMBER;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PEER_MEMBER
{
    public uint dwSize;
    public uint dwFlags;
    public IntPtr pwzIdentity;
    public IntPtr pwzAttributes;
    public ulong ullNodeId;
    public uint cAddresses;
    public IntPtr pAddresses;
    public IntPtr pCredentialInfo;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PEER_MEMBER
    Public dwSize As UInteger
    Public dwFlags As UInteger
    Public pwzIdentity As IntPtr
    Public pwzAttributes As IntPtr
    Public ullNodeId As ULong
    Public cAddresses As UInteger
    Public pAddresses As IntPtr
    Public pCredentialInfo As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class PEER_MEMBER(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("pwzIdentity", ctypes.c_void_p),
        ("pwzAttributes", ctypes.c_void_p),
        ("ullNodeId", ctypes.c_ulonglong),
        ("cAddresses", wintypes.DWORD),
        ("pAddresses", ctypes.c_void_p),
        ("pCredentialInfo", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct PEER_MEMBER {
    pub dwSize: u32,
    pub dwFlags: u32,
    pub pwzIdentity: *mut core::ffi::c_void,
    pub pwzAttributes: *mut core::ffi::c_void,
    pub ullNodeId: u64,
    pub cAddresses: u32,
    pub pAddresses: *mut core::ffi::c_void,
    pub pCredentialInfo: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type PEER_MEMBER struct {
	dwSize uint32
	dwFlags uint32
	pwzIdentity uintptr
	pwzAttributes uintptr
	ullNodeId uint64
	cAddresses uint32
	pAddresses uintptr
	pCredentialInfo uintptr
}
type
  PEER_MEMBER = record
    dwSize: DWORD;
    dwFlags: DWORD;
    pwzIdentity: Pointer;
    pwzAttributes: Pointer;
    ullNodeId: UInt64;
    cAddresses: DWORD;
    pAddresses: Pointer;
    pCredentialInfo: Pointer;
  end;
const PEER_MEMBER = extern struct {
    dwSize: u32,
    dwFlags: u32,
    pwzIdentity: ?*anyopaque,
    pwzAttributes: ?*anyopaque,
    ullNodeId: u64,
    cAddresses: u32,
    pAddresses: ?*anyopaque,
    pCredentialInfo: ?*anyopaque,
};
type
  PEER_MEMBER {.bycopy.} = object
    dwSize: uint32
    dwFlags: uint32
    pwzIdentity: pointer
    pwzAttributes: pointer
    ullNodeId: uint64
    cAddresses: uint32
    pAddresses: pointer
    pCredentialInfo: pointer
struct PEER_MEMBER
{
    uint dwSize;
    uint dwFlags;
    void* pwzIdentity;
    void* pwzAttributes;
    ulong ullNodeId;
    uint cAddresses;
    void* pAddresses;
    void* pCredentialInfo;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PEER_MEMBER サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pwzIdentity : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pwzAttributes : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ullNodeId : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; cAddresses : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; pAddresses : PEER_ADDRESS* (+28, 4byte)  varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; pCredentialInfo : PEER_CREDENTIAL_INFO* (+32, 4byte)  varptr(st)+32 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PEER_MEMBER サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pwzIdentity : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pwzAttributes : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ullNodeId : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; cAddresses : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; pAddresses : PEER_ADDRESS* (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; pCredentialInfo : PEER_CREDENTIAL_INFO* (+48, 8byte)  varptr(st)+48 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PEER_MEMBER
    #field int dwSize
    #field int dwFlags
    #field intptr pwzIdentity
    #field intptr pwzAttributes
    #field int64 ullNodeId
    #field int cAddresses
    #field intptr pAddresses
    #field intptr pCredentialInfo
#endstruct

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