PEER_EVENT_OBJECT_CHANGED_DATA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| pContact | PEER_CONTACT* | 8/4 | +0 | +0 | ピア オブジェクト データが変更されたコンタクトのピア コンタクト情報を格納する PEER_CONTACT 構造体へのポインターです。 |
| pEndpoint | PEER_ENDPOINT* | 8/4 | +8 | +4 | ピア オブジェクト データが変更されたコンタクトのピア エンドポイント情報を格納する PEER_ENDPOINT 構造体へのポインターです。 |
| changeType | PEER_CHANGE_TYPE | 4 | +16 | +8 | 発生した変更の種類を指定する PEER_CHANGE_TYPE 列挙型の値です。 |
| pObject | PEER_OBJECT* | 8/4 | +24 | +12 | 変更によってイベントが発生したピア オブジェクト データを格納する PEER_OBJECT 構造体へのポインターです。これは、新しいピア オブジェクトをピアが受信したときに最もよく発生します。 |
公式ドキュメント
PEER_EVENT_OBJECT_CHANGED_DATA 構造体は、ピア コラボレーション ネットワークに参加しているピアで PEER_EVENT_ENDPOINT_OBJECT_CHANGED イベントまたは PEER_EVENT_MY_OBJECT_CHANGED イベントが発生したときに返される情報を格納します。
解説(Remarks)
ピア オブジェクトは、画像やアバター、証明書、特定の説明など、特定のアプリケーションに関連付けられた実行時のデータ項目です。各ピア オブジェクトのサイズは 16K 未満でなければなりません。
このピア オブジェクトを監視している信頼されたコンタクトでは、ピア オブジェクトの状態の変更を通知する PEER_EVENT_OBJECT_CHANGED イベントが発生します。
PEER_EVENT_OBJECT_CHANGED イベントは、PeerCollabSetObject を呼び出してオブジェクトが変更されたときに発生します。オブジェクトが初めて設定された場合、changeType には PEER_CHANGE_ADDED が設定されます。同じオブジェクト ID に対して PeerCollabSetObject を続けて呼び出した場合、changeType には PEER_CHANGE_UDPATED が設定されます。
PeerCollabDeleteObject が呼び出された場合は、PEER_CHANGE_DELETED イベントが発生します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// PEER_EVENT_OBJECT_CHANGED_DATA (x64 32 / x86 16 バイト)
typedef struct PEER_EVENT_OBJECT_CHANGED_DATA {
PEER_CONTACT* pContact;
PEER_ENDPOINT* pEndpoint;
PEER_CHANGE_TYPE changeType;
PEER_OBJECT* pObject;
} PEER_EVENT_OBJECT_CHANGED_DATA;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PEER_EVENT_OBJECT_CHANGED_DATA
{
public IntPtr pContact;
public IntPtr pEndpoint;
public int changeType;
public IntPtr pObject;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PEER_EVENT_OBJECT_CHANGED_DATA
Public pContact As IntPtr
Public pEndpoint As IntPtr
Public changeType As Integer
Public pObject As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class PEER_EVENT_OBJECT_CHANGED_DATA(ctypes.Structure):
_fields_ = [
("pContact", ctypes.c_void_p),
("pEndpoint", ctypes.c_void_p),
("changeType", ctypes.c_int),
("pObject", ctypes.c_void_p),
]#[repr(C)]
pub struct PEER_EVENT_OBJECT_CHANGED_DATA {
pub pContact: *mut core::ffi::c_void,
pub pEndpoint: *mut core::ffi::c_void,
pub changeType: i32,
pub pObject: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type PEER_EVENT_OBJECT_CHANGED_DATA struct {
pContact uintptr
pEndpoint uintptr
changeType int32
pObject uintptr
}type
PEER_EVENT_OBJECT_CHANGED_DATA = record
pContact: Pointer;
pEndpoint: Pointer;
changeType: Integer;
pObject: Pointer;
end;const PEER_EVENT_OBJECT_CHANGED_DATA = extern struct {
pContact: ?*anyopaque,
pEndpoint: ?*anyopaque,
changeType: i32,
pObject: ?*anyopaque,
};type
PEER_EVENT_OBJECT_CHANGED_DATA {.bycopy.} = object
pContact: pointer
pEndpoint: pointer
changeType: int32
pObject: pointerstruct PEER_EVENT_OBJECT_CHANGED_DATA
{
void* pContact;
void* pEndpoint;
int changeType;
void* pObject;
}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_OBJECT_CHANGED_DATA サイズ: 16 バイト(x86)
dim st, 4 ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; pContact : PEER_CONTACT* (+0, 4byte) varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; pEndpoint : PEER_ENDPOINT* (+4, 4byte) varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; changeType : PEER_CHANGE_TYPE (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; pObject : PEER_OBJECT* (+12, 4byte) varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PEER_EVENT_OBJECT_CHANGED_DATA サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; pContact : PEER_CONTACT* (+0, 8byte) varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; pEndpoint : PEER_ENDPOINT* (+8, 8byte) varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; changeType : PEER_CHANGE_TYPE (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; pObject : PEER_OBJECT* (+24, 8byte) varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PEER_EVENT_OBJECT_CHANGED_DATA
#field intptr pContact
#field intptr pEndpoint
#field int changeType
#field intptr pObject
#endstruct
stdim st, PEER_EVENT_OBJECT_CHANGED_DATA ; NSTRUCT 変数を確保
st->changeType = 100
mes "changeType=" + st->changeType