PEER_EVENT_WATCHLIST_CHANGED_DATA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| pContact | PEER_CONTACT* | 8/4 | +0 | +0 | イベントの発生要因となった変更が生じた、ウォッチリスト内のピア連絡先に関する情報を格納する PEER_CONTACT 構造体へのポインターです。 |
| changeType | PEER_CHANGE_TYPE | 4 | +8 | +4 | ピアのウォッチリストで発生した変更の種類を指定する PEER_CHANGE_TYPE 列挙型の値です。 |
公式ドキュメント
PEER_EVENT_WATCHLIST_CHANGED_DATA 構造体は、ピアコラボレーションネットワークに参加しているピアで PEER_EVENT_WATCHLIST_CHANGED イベントが発生したときに返される情報を格納します。
解説(Remarks)
PEER_EVENT_WATCHLIST_CHANGED イベントは、ウォッチリストが変更されたときに発生します。ウォッチリストは、fWatch が true に設定されている連絡先で構成されます。fWatch が true に設定された新しい連絡先が追加された場合、または既存の連絡先の fWatch が true に変更された場合、changeType メンバーは PEER_CHANGE_ADDED に設定されます。fWatch が false に変更された場合、または連絡先が削除された場合、changeType は PEER_CHANGE_DELETED に設定されます。
このイベントを受け取るには、p2phost.exe サービスが実行中でなければなりません。P2phost.exe は、アプリケーションがこのイベントに対して PeerCollabRegisterEvent を呼び出したときに起動されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// PEER_EVENT_WATCHLIST_CHANGED_DATA (x64 16 / x86 8 バイト)
typedef struct PEER_EVENT_WATCHLIST_CHANGED_DATA {
PEER_CONTACT* pContact;
PEER_CHANGE_TYPE changeType;
} PEER_EVENT_WATCHLIST_CHANGED_DATA;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PEER_EVENT_WATCHLIST_CHANGED_DATA
{
public IntPtr pContact;
public int changeType;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PEER_EVENT_WATCHLIST_CHANGED_DATA
Public pContact As IntPtr
Public changeType As Integer
End Structureimport ctypes
from ctypes import wintypes
class PEER_EVENT_WATCHLIST_CHANGED_DATA(ctypes.Structure):
_fields_ = [
("pContact", ctypes.c_void_p),
("changeType", ctypes.c_int),
]#[repr(C)]
pub struct PEER_EVENT_WATCHLIST_CHANGED_DATA {
pub pContact: *mut core::ffi::c_void,
pub changeType: i32,
}import "golang.org/x/sys/windows"
type PEER_EVENT_WATCHLIST_CHANGED_DATA struct {
pContact uintptr
changeType int32
}type
PEER_EVENT_WATCHLIST_CHANGED_DATA = record
pContact: Pointer;
changeType: Integer;
end;const PEER_EVENT_WATCHLIST_CHANGED_DATA = extern struct {
pContact: ?*anyopaque,
changeType: i32,
};type
PEER_EVENT_WATCHLIST_CHANGED_DATA {.bycopy.} = object
pContact: pointer
changeType: int32struct PEER_EVENT_WATCHLIST_CHANGED_DATA
{
void* pContact;
int changeType;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PEER_EVENT_WATCHLIST_CHANGED_DATA サイズ: 8 バイト(x86)
dim st, 2 ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; pContact : PEER_CONTACT* (+0, 4byte) varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; changeType : PEER_CHANGE_TYPE (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PEER_EVENT_WATCHLIST_CHANGED_DATA サイズ: 16 バイト(x64)
dim st, 4 ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; pContact : PEER_CONTACT* (+0, 8byte) varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; changeType : PEER_CHANGE_TYPE (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PEER_EVENT_WATCHLIST_CHANGED_DATA
#field intptr pContact
#field int changeType
#endstruct
stdim st, PEER_EVENT_WATCHLIST_CHANGED_DATA ; NSTRUCT 変数を確保
st->changeType = 100
mes "changeType=" + st->changeType