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

PEER_RECORD

構造体
サイズx64: 128 バイト / x86: 96 バイト

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のサイズをバイト単位で示す値。
typeGUID16+4+4レコードの種別を識別するGUID。
idGUID16+20+20レコードを一意に識別するGUID。
dwVersionDWORD4+36+36レコードのバージョン番号。
dwFlagsDWORD4+40+40レコードの属性を示すフラグ。
pwzCreatorIdLPWSTR8/4+48+44レコード作成者のIDを表すNULL終端ワイド文字列。
pwzModifiedByIdLPWSTR8/4+56+48最終更新者のIDを表すNULL終端ワイド文字列。
pwzAttributesLPWSTR8/4+64+52XML形式の属性文字列。検索に使用される。NULL可。
ftCreationFILETIME8+72+56レコードの作成日時を示すFILETIME。
ftExpirationFILETIME8+80+64レコードの有効期限を示すFILETIME。
ftLastModifiedFILETIME8+88+72レコードの最終更新日時を示すFILETIME。
securityDataPEER_DATA16/8+96+80セキュリティプロバイダ用のデータを保持するPEER_DATA。
dataPEER_DATA16/8+112+88レコード本体のデータを保持するPEER_DATA。

各言語での定義

#include <windows.h>

// FILETIME  (x64 8 / x86 8 バイト)
typedef struct FILETIME {
    DWORD dwLowDateTime;
    DWORD dwHighDateTime;
} FILETIME;

// PEER_DATA  (x64 16 / x86 8 バイト)
typedef struct PEER_DATA {
    DWORD cbData;
    BYTE* pbData;
} PEER_DATA;

// PEER_RECORD  (x64 128 / x86 96 バイト)
typedef struct PEER_RECORD {
    DWORD dwSize;
    GUID type;
    GUID id;
    DWORD dwVersion;
    DWORD dwFlags;
    LPWSTR pwzCreatorId;
    LPWSTR pwzModifiedById;
    LPWSTR pwzAttributes;
    FILETIME ftCreation;
    FILETIME ftExpiration;
    FILETIME ftLastModified;
    PEER_DATA securityData;
    PEER_DATA data;
} PEER_RECORD;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PEER_DATA
{
    public uint cbData;
    public IntPtr pbData;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PEER_RECORD
{
    public uint dwSize;
    public Guid type;
    public Guid id;
    public uint dwVersion;
    public uint dwFlags;
    public IntPtr pwzCreatorId;
    public IntPtr pwzModifiedById;
    public IntPtr pwzAttributes;
    public FILETIME ftCreation;
    public FILETIME ftExpiration;
    public FILETIME ftLastModified;
    public PEER_DATA securityData;
    public PEER_DATA data;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILETIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PEER_DATA
    Public cbData As UInteger
    Public pbData As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PEER_RECORD
    Public dwSize As UInteger
    Public type As Guid
    Public id As Guid
    Public dwVersion As UInteger
    Public dwFlags As UInteger
    Public pwzCreatorId As IntPtr
    Public pwzModifiedById As IntPtr
    Public pwzAttributes As IntPtr
    Public ftCreation As FILETIME
    Public ftExpiration As FILETIME
    Public ftLastModified As FILETIME
    Public securityData As PEER_DATA
    Public data As PEER_DATA
End Structure
import ctypes
from ctypes import wintypes

class FILETIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class PEER_DATA(ctypes.Structure):
    _fields_ = [
        ("cbData", wintypes.DWORD),
        ("pbData", ctypes.c_void_p),
    ]

class PEER_RECORD(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("type", GUID),
        ("id", GUID),
        ("dwVersion", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("pwzCreatorId", ctypes.c_void_p),
        ("pwzModifiedById", ctypes.c_void_p),
        ("pwzAttributes", ctypes.c_void_p),
        ("ftCreation", FILETIME),
        ("ftExpiration", FILETIME),
        ("ftLastModified", FILETIME),
        ("securityData", PEER_DATA),
        ("data", PEER_DATA),
    ]
#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct PEER_DATA {
    pub cbData: u32,
    pub pbData: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct PEER_RECORD {
    pub dwSize: u32,
    pub type: GUID,
    pub id: GUID,
    pub dwVersion: u32,
    pub dwFlags: u32,
    pub pwzCreatorId: *mut core::ffi::c_void,
    pub pwzModifiedById: *mut core::ffi::c_void,
    pub pwzAttributes: *mut core::ffi::c_void,
    pub ftCreation: FILETIME,
    pub ftExpiration: FILETIME,
    pub ftLastModified: FILETIME,
    pub securityData: PEER_DATA,
    pub data: PEER_DATA,
}
import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type PEER_DATA struct {
	cbData uint32
	pbData uintptr
}

type PEER_RECORD struct {
	dwSize uint32
	type windows.GUID
	id windows.GUID
	dwVersion uint32
	dwFlags uint32
	pwzCreatorId uintptr
	pwzModifiedById uintptr
	pwzAttributes uintptr
	ftCreation FILETIME
	ftExpiration FILETIME
	ftLastModified FILETIME
	securityData PEER_DATA
	data PEER_DATA
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  PEER_DATA = record
    cbData: DWORD;
    pbData: Pointer;
  end;

  PEER_RECORD = record
    dwSize: DWORD;
    type: TGUID;
    id: TGUID;
    dwVersion: DWORD;
    dwFlags: DWORD;
    pwzCreatorId: Pointer;
    pwzModifiedById: Pointer;
    pwzAttributes: Pointer;
    ftCreation: FILETIME;
    ftExpiration: FILETIME;
    ftLastModified: FILETIME;
    securityData: PEER_DATA;
    data: PEER_DATA;
  end;
const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const PEER_DATA = extern struct {
    cbData: u32,
    pbData: ?*anyopaque,
};

const PEER_RECORD = extern struct {
    dwSize: u32,
    type: GUID,
    id: GUID,
    dwVersion: u32,
    dwFlags: u32,
    pwzCreatorId: ?*anyopaque,
    pwzModifiedById: ?*anyopaque,
    pwzAttributes: ?*anyopaque,
    ftCreation: FILETIME,
    ftExpiration: FILETIME,
    ftLastModified: FILETIME,
    securityData: PEER_DATA,
    data: PEER_DATA,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  PEER_DATA {.bycopy.} = object
    cbData: uint32
    pbData: pointer

  PEER_RECORD {.bycopy.} = object
    dwSize: uint32
    type: GUID
    id: GUID
    dwVersion: uint32
    dwFlags: uint32
    pwzCreatorId: pointer
    pwzModifiedById: pointer
    pwzAttributes: pointer
    ftCreation: FILETIME
    ftExpiration: FILETIME
    ftLastModified: FILETIME
    securityData: PEER_DATA
    data: PEER_DATA
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct PEER_DATA
{
    uint cbData;
    void* pbData;
}

struct PEER_RECORD
{
    uint dwSize;
    GUID type;
    GUID id;
    uint dwVersion;
    uint dwFlags;
    void* pwzCreatorId;
    void* pwzModifiedById;
    void* pwzAttributes;
    FILETIME ftCreation;
    FILETIME ftExpiration;
    FILETIME ftLastModified;
    PEER_DATA securityData;
    PEER_DATA data;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PEER_RECORD サイズ: 96 バイト(x86)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; type : GUID (+4, 16byte)  varptr(st)+4 を基点に操作(16byte:入れ子/配列)
; id : GUID (+20, 16byte)  varptr(st)+20 を基点に操作(16byte:入れ子/配列)
; dwVersion : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dwFlags : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; pwzCreatorId : LPWSTR (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; pwzModifiedById : LPWSTR (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; pwzAttributes : LPWSTR (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; ftCreation : FILETIME (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; ftExpiration : FILETIME (+64, 8byte)  varptr(st)+64 を基点に操作(8byte:入れ子/配列)
; ftLastModified : FILETIME (+72, 8byte)  varptr(st)+72 を基点に操作(8byte:入れ子/配列)
; securityData : PEER_DATA (+80, 8byte)  varptr(st)+80 を基点に操作(8byte:入れ子/配列)
; data : PEER_DATA (+88, 8byte)  varptr(st)+88 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PEER_RECORD サイズ: 128 バイト(x64)
dim st, 32    ; 4byte整数×32(構造体サイズ 128 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; type : GUID (+4, 16byte)  varptr(st)+4 を基点に操作(16byte:入れ子/配列)
; id : GUID (+20, 16byte)  varptr(st)+20 を基点に操作(16byte:入れ子/配列)
; dwVersion : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dwFlags : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; pwzCreatorId : LPWSTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; pwzModifiedById : LPWSTR (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; pwzAttributes : LPWSTR (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ftCreation : FILETIME (+72, 8byte)  varptr(st)+72 を基点に操作(8byte:入れ子/配列)
; ftExpiration : FILETIME (+80, 8byte)  varptr(st)+80 を基点に操作(8byte:入れ子/配列)
; ftLastModified : FILETIME (+88, 8byte)  varptr(st)+88 を基点に操作(8byte:入れ子/配列)
; securityData : PEER_DATA (+96, 16byte)  varptr(st)+96 を基点に操作(16byte:入れ子/配列)
; data : PEER_DATA (+112, 16byte)  varptr(st)+112 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global PEER_DATA
    #field int cbData
    #field intptr pbData
#endstruct

#defstruct global PEER_RECORD
    #field int dwSize
    #field GUID type
    #field GUID id
    #field int dwVersion
    #field int dwFlags
    #field intptr pwzCreatorId
    #field intptr pwzModifiedById
    #field intptr pwzAttributes
    #field FILETIME ftCreation
    #field FILETIME ftExpiration
    #field FILETIME ftLastModified
    #field PEER_DATA securityData
    #field PEER_DATA data
#endstruct

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