ホーム › NetworkManagement.P2P › PEER_EVENT_CONNECTION_CHANGE_DATA

PEER_EVENT_CONNECTION_CHANGE_DATA

構造体

📘 Microsoft Learn (日本語) · English

サイズx64: 40 バイト / x86: 40 バイト

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

フィールド

型

サイズ

x64

x86

説明

dwSize

DWORD

構造体のサイズを指定します。

status

PEER_CONNECTION_STATUS

ネイバー接続または直接接続における変更の種類を指定します。有効な値は次のとおりです。

値	意味
PEER_CONNECTED	ローカルノードへの新しい着信接続または発信接続が確立されました。
PEER_CONNECTION_FAILED	ローカルノードへの接続の試行が失敗しました。 1 回の接続試行が複数の接続失敗を引き起こすことがあります。これは最初の接続失敗の後、ピアインフラストラクチャが ullNextConnectionId メンバーをノード ID に設定して新たに接続を試みるときに発生します。ullNextConnectionId メンバーが 0 の場合、それ以上の接続は試行されません。
PEER_DISCONNECTED	既存の接続が切断されました。

ullConnectionId

ULONGLONG

変更が発生した接続の一意の ID を指定します。

ullNodeId

ULONGLONG

+16

変更が発生したノードの一意の ID を指定します。

ullNextConnectionId

ULONGLONG

+24

Windows Vista 以降。 接続が失敗したときに、グループ化 API またはグラフ化 API が接続を試みる次の利用可能なノード ID が格納されます。このメンバーの値が 0 の場合、それ以上の接続は試行されません。

hrConnectionFailedReason

HRESULT

+32

Windows Vista 以降。 接続が失敗したときのエラーの種類を指定します。 hrConnectionFailedReason は次のエラーコードを返すことがあります。

値	説明
PEER_E_CONNECTION_REFUSED	接続が確立された後に拒否されました。リモートノードが既に最大接続数に達しているか、接続が既に存在しています。
PEER_E_CONNECTION_FAILED	リモートノードへの接続の試行が失敗しました。
PEER_E_CONNECTION_NOT_AUTHENTICATED	認証フェーズ中に接続が失われました。これはネットワーク障害、またはリモートノードが接続を切断したことによるものです。

公式ドキュメント

次のいずれかのピアイベントがトリガーされた場合、PEER_GRAPH_EVENT_DATA 構造体は PEER_EVENT_CONNECTION_CHANGE_DATA 構造体を指します。

PEER_EVENT_CONNECTION_CHANGE_DATA 構造体には、ネイバー接続または直接接続の変更を含む更新された情報が格納されます。

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

各言語での定義

#include <windows.h>

// PEER_EVENT_CONNECTION_CHANGE_DATA  (x64 40 / x86 40 バイト)
typedef struct PEER_EVENT_CONNECTION_CHANGE_DATA {
    DWORD dwSize;
    PEER_CONNECTION_STATUS status;
    ULONGLONG ullConnectionId;
    ULONGLONG ullNodeId;
    ULONGLONG ullNextConnectionId;
    HRESULT hrConnectionFailedReason;
} PEER_EVENT_CONNECTION_CHANGE_DATA;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PEER_EVENT_CONNECTION_CHANGE_DATA
{
    public uint dwSize;
    public int status;
    public ulong ullConnectionId;
    public ulong ullNodeId;
    public ulong ullNextConnectionId;
    public int hrConnectionFailedReason;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PEER_EVENT_CONNECTION_CHANGE_DATA
    Public dwSize As UInteger
    Public status As Integer
    Public ullConnectionId As ULong
    Public ullNodeId As ULong
    Public ullNextConnectionId As ULong
    Public hrConnectionFailedReason As Integer
End Structure

import ctypes
from ctypes import wintypes

class PEER_EVENT_CONNECTION_CHANGE_DATA(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("status", ctypes.c_int),
        ("ullConnectionId", ctypes.c_ulonglong),
        ("ullNodeId", ctypes.c_ulonglong),
        ("ullNextConnectionId", ctypes.c_ulonglong),
        ("hrConnectionFailedReason", ctypes.c_int),
    ]

#[repr(C)]
pub struct PEER_EVENT_CONNECTION_CHANGE_DATA {
    pub dwSize: u32,
    pub status: i32,
    pub ullConnectionId: u64,
    pub ullNodeId: u64,
    pub ullNextConnectionId: u64,
    pub hrConnectionFailedReason: i32,
}

import "golang.org/x/sys/windows"

type PEER_EVENT_CONNECTION_CHANGE_DATA struct {
	dwSize uint32
	status int32
	ullConnectionId uint64
	ullNodeId uint64
	ullNextConnectionId uint64
	hrConnectionFailedReason int32
}

type
  PEER_EVENT_CONNECTION_CHANGE_DATA = record
    dwSize: DWORD;
    status: Integer;
    ullConnectionId: UInt64;
    ullNodeId: UInt64;
    ullNextConnectionId: UInt64;
    hrConnectionFailedReason: Integer;
  end;

const PEER_EVENT_CONNECTION_CHANGE_DATA = extern struct {
    dwSize: u32,
    status: i32,
    ullConnectionId: u64,
    ullNodeId: u64,
    ullNextConnectionId: u64,
    hrConnectionFailedReason: i32,
};

type
  PEER_EVENT_CONNECTION_CHANGE_DATA {.bycopy.} = object
    dwSize: uint32
    status: int32
    ullConnectionId: uint64
    ullNodeId: uint64
    ullNextConnectionId: uint64
    hrConnectionFailedReason: int32

struct PEER_EVENT_CONNECTION_CHANGE_DATA
{
    uint dwSize;
    int status;
    ulong ullConnectionId;
    ulong ullNodeId;
    ulong ullNextConnectionId;
    int hrConnectionFailedReason;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PEER_EVENT_CONNECTION_CHANGE_DATA サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; status : PEER_CONNECTION_STATUS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ullConnectionId : ULONGLONG (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; ullNodeId : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ullNextConnectionId : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; hrConnectionFailedReason : HRESULT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PEER_EVENT_CONNECTION_CHANGE_DATA
    #field int dwSize
    #field int status
    #field int64 ullConnectionId
    #field int64 ullNodeId
    #field int64 ullNextConnectionId
    #field int hrConnectionFailedReason
#endstruct

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

PEER_EVENT_CONNECTION_CHANGE_DATA

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義