ホーム › NetworkManagement.P2P › PEER_INVITATION_INFO

PEER_INVITATION_INFO

構造体

📘 Microsoft Learn (日本語) · English

サイズx64: 136 バイト / x86: 84 バイト

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

フィールド

型

サイズ

x64

x86

説明

dwSize

DWORD

この構造体のサイズをバイト単位で指定します。

dwFlags

DWORD

0x00000000 に設定しなければなりません。

pwzCloudName

LPWSTR

8/4

PNRP クラウド名を指定する Unicode 文字列へのポインターです。

dwScope

DWORD

+16

+12

ピアグループが登録されたスコープを指定します。

Value	Meaning
PNRP_GLOBAL_SCOPE	インターネットを含むグローバルスコープです。
PNRP_LOCAL_SCOPE	ローカルスコープです。
PNRP_LINK_LOCAL_SCOPE	リンクローカルスコープです。

dwCloudFlags

DWORD

+20

+16

PNRP クラウドの機能を表すフラグのセットを指定します。

Value	Meaning
PNRP_CLOUD_NO_FLAGS 0	フラグは設定されていません。
PNRP_CLOUD_NAME_LOCAL 1	クラウド名は他のコンピューターでは利用できません。ローカルに定義されています。

pwzGroupPeerName

LPWSTR

8/4

+24

+20

ピアグループのピア名を指定する Unicode 文字列へのポインターです。

pwzIssuerPeerName

LPWSTR

8/4

+32

+24

招待を発行するピアの PNRP 名を指定する Unicode 文字列へのポインターです。

pwzSubjectPeerName

LPWSTR

8/4

+40

+28

招待を受け取るピアの PNRP 名を指定する Unicode 文字列へのポインターです。

pwzGroupFriendlyName

LPWSTR

8/4

+48

+32

ピアグループのフレンドリ名 (表示名) を指定する Unicode 文字列へのポインターです。

pwzIssuerFriendlyName

LPWSTR

8/4

+56

+36

招待を発行するピアのフレンドリ名 (表示名) を指定する Unicode 文字列へのポインターです。

pwzSubjectFriendlyName

LPWSTR

8/4

+64

+40

招待を受け取るピアのフレンドリ名 (表示名) を指定する Unicode 文字列へのポインターです。

ftValidityStart

FILETIME

+72

+44

招待が有効になる日時を示す UTC の FILETIME 値を指定します。

ftValidityEnd

FILETIME

+80

+52

招待が無効になる日時を示す UTC の FILETIME 値を指定します。

cRoles

DWORD

+88

+60

pRoles に格納されているロール GUID の数を指定します。

pRoles

GUID*

8/4

+96

+64

利用可能なロールの組み合わせを指定する GUID のリストへのポインターです。利用可能なロールは次のとおりです。

Value	Meaning
PEER_GROUP_ROLE_ADMIN	このロールは、招待の発行、メンバーシップの更新、ピアグループのプロパティの変更、レコードの発行と更新、および他の管理者の GMC の更新を行うことができます。
PEER_GROUP_ROLE_MEMBER	このロールは、ピアグループのデータベースにレコードを発行できます。

cClassifiers

DWORD

+104

+68

ppwzClassifiers に列挙されている文字列値の数を格納する符号なし整数値です。このフィールドは将来の使用のために予約済みです。

ppwzClassifiers

LPWSTR*

8/4

+112

+72

Unicode 文字列へのポインターのリストです。このフィールドは将来の使用のために予約済みです。

pSubjectPublicKey

CERT_PUBLIC_KEY_INFO*

8/4

+120

+76

受信者から返された公開キーと、それが使用する暗号化アルゴリズムの種類を格納する CERT_PUBLIC_KEY_INFO 構造体へのポインターです。

authScheme

PEER_GROUP_AUTHENTICATION_SCHEME

+128

+80

Windows Vista 以降。 ピアグループへの招待対象者を検証するために使用される認証の種類を示す PEER_GROUP_AUTHENTICATION_SCHEME 列挙型の値です。

公式ドキュメント

PEER_INVITATION_INFO 構造体は、ピアグループへの参加招待に関する情報を定義します。招待は Unicode 文字列として表されます。この構造体を取得するには、PeerGroupCreateInvitation で作成された XML の招待文字列を PeerGroupParseInvitation に渡します。

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

各言語での定義

#include <windows.h>

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

// PEER_INVITATION_INFO  (x64 136 / x86 84 バイト)
typedef struct PEER_INVITATION_INFO {
    DWORD dwSize;
    DWORD dwFlags;
    LPWSTR pwzCloudName;
    DWORD dwScope;
    DWORD dwCloudFlags;
    LPWSTR pwzGroupPeerName;
    LPWSTR pwzIssuerPeerName;
    LPWSTR pwzSubjectPeerName;
    LPWSTR pwzGroupFriendlyName;
    LPWSTR pwzIssuerFriendlyName;
    LPWSTR pwzSubjectFriendlyName;
    FILETIME ftValidityStart;
    FILETIME ftValidityEnd;
    DWORD cRoles;
    GUID* pRoles;
    DWORD cClassifiers;
    LPWSTR* ppwzClassifiers;
    CERT_PUBLIC_KEY_INFO* pSubjectPublicKey;
    PEER_GROUP_AUTHENTICATION_SCHEME authScheme;
} PEER_INVITATION_INFO;

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_INVITATION_INFO
{
    public uint dwSize;
    public uint dwFlags;
    public IntPtr pwzCloudName;
    public uint dwScope;
    public uint dwCloudFlags;
    public IntPtr pwzGroupPeerName;
    public IntPtr pwzIssuerPeerName;
    public IntPtr pwzSubjectPeerName;
    public IntPtr pwzGroupFriendlyName;
    public IntPtr pwzIssuerFriendlyName;
    public IntPtr pwzSubjectFriendlyName;
    public FILETIME ftValidityStart;
    public FILETIME ftValidityEnd;
    public uint cRoles;
    public IntPtr pRoles;
    public uint cClassifiers;
    public IntPtr ppwzClassifiers;
    public IntPtr pSubjectPublicKey;
    public int authScheme;
}

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_INVITATION_INFO
    Public dwSize As UInteger
    Public dwFlags As UInteger
    Public pwzCloudName As IntPtr
    Public dwScope As UInteger
    Public dwCloudFlags As UInteger
    Public pwzGroupPeerName As IntPtr
    Public pwzIssuerPeerName As IntPtr
    Public pwzSubjectPeerName As IntPtr
    Public pwzGroupFriendlyName As IntPtr
    Public pwzIssuerFriendlyName As IntPtr
    Public pwzSubjectFriendlyName As IntPtr
    Public ftValidityStart As FILETIME
    Public ftValidityEnd As FILETIME
    Public cRoles As UInteger
    Public pRoles As IntPtr
    Public cClassifiers As UInteger
    Public ppwzClassifiers As IntPtr
    Public pSubjectPublicKey As IntPtr
    Public authScheme As Integer
End Structure

import ctypes
from ctypes import wintypes

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

class PEER_INVITATION_INFO(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("pwzCloudName", ctypes.c_void_p),
        ("dwScope", wintypes.DWORD),
        ("dwCloudFlags", wintypes.DWORD),
        ("pwzGroupPeerName", ctypes.c_void_p),
        ("pwzIssuerPeerName", ctypes.c_void_p),
        ("pwzSubjectPeerName", ctypes.c_void_p),
        ("pwzGroupFriendlyName", ctypes.c_void_p),
        ("pwzIssuerFriendlyName", ctypes.c_void_p),
        ("pwzSubjectFriendlyName", ctypes.c_void_p),
        ("ftValidityStart", FILETIME),
        ("ftValidityEnd", FILETIME),
        ("cRoles", wintypes.DWORD),
        ("pRoles", ctypes.c_void_p),
        ("cClassifiers", wintypes.DWORD),
        ("ppwzClassifiers", ctypes.c_void_p),
        ("pSubjectPublicKey", ctypes.c_void_p),
        ("authScheme", ctypes.c_int),
    ]

#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct PEER_INVITATION_INFO {
    pub dwSize: u32,
    pub dwFlags: u32,
    pub pwzCloudName: *mut core::ffi::c_void,
    pub dwScope: u32,
    pub dwCloudFlags: u32,
    pub pwzGroupPeerName: *mut core::ffi::c_void,
    pub pwzIssuerPeerName: *mut core::ffi::c_void,
    pub pwzSubjectPeerName: *mut core::ffi::c_void,
    pub pwzGroupFriendlyName: *mut core::ffi::c_void,
    pub pwzIssuerFriendlyName: *mut core::ffi::c_void,
    pub pwzSubjectFriendlyName: *mut core::ffi::c_void,
    pub ftValidityStart: FILETIME,
    pub ftValidityEnd: FILETIME,
    pub cRoles: u32,
    pub pRoles: *mut core::ffi::c_void,
    pub cClassifiers: u32,
    pub ppwzClassifiers: *mut core::ffi::c_void,
    pub pSubjectPublicKey: *mut core::ffi::c_void,
    pub authScheme: i32,
}

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

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type PEER_INVITATION_INFO struct {
	dwSize uint32
	dwFlags uint32
	pwzCloudName uintptr
	dwScope uint32
	dwCloudFlags uint32
	pwzGroupPeerName uintptr
	pwzIssuerPeerName uintptr
	pwzSubjectPeerName uintptr
	pwzGroupFriendlyName uintptr
	pwzIssuerFriendlyName uintptr
	pwzSubjectFriendlyName uintptr
	ftValidityStart FILETIME
	ftValidityEnd FILETIME
	cRoles uint32
	pRoles uintptr
	cClassifiers uint32
	ppwzClassifiers uintptr
	pSubjectPublicKey uintptr
	authScheme int32
}

type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  PEER_INVITATION_INFO = record
    dwSize: DWORD;
    dwFlags: DWORD;
    pwzCloudName: Pointer;
    dwScope: DWORD;
    dwCloudFlags: DWORD;
    pwzGroupPeerName: Pointer;
    pwzIssuerPeerName: Pointer;
    pwzSubjectPeerName: Pointer;
    pwzGroupFriendlyName: Pointer;
    pwzIssuerFriendlyName: Pointer;
    pwzSubjectFriendlyName: Pointer;
    ftValidityStart: FILETIME;
    ftValidityEnd: FILETIME;
    cRoles: DWORD;
    pRoles: Pointer;
    cClassifiers: DWORD;
    ppwzClassifiers: Pointer;
    pSubjectPublicKey: Pointer;
    authScheme: Integer;
  end;

const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const PEER_INVITATION_INFO = extern struct {
    dwSize: u32,
    dwFlags: u32,
    pwzCloudName: ?*anyopaque,
    dwScope: u32,
    dwCloudFlags: u32,
    pwzGroupPeerName: ?*anyopaque,
    pwzIssuerPeerName: ?*anyopaque,
    pwzSubjectPeerName: ?*anyopaque,
    pwzGroupFriendlyName: ?*anyopaque,
    pwzIssuerFriendlyName: ?*anyopaque,
    pwzSubjectFriendlyName: ?*anyopaque,
    ftValidityStart: FILETIME,
    ftValidityEnd: FILETIME,
    cRoles: u32,
    pRoles: ?*anyopaque,
    cClassifiers: u32,
    ppwzClassifiers: ?*anyopaque,
    pSubjectPublicKey: ?*anyopaque,
    authScheme: i32,
};

type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  PEER_INVITATION_INFO {.bycopy.} = object
    dwSize: uint32
    dwFlags: uint32
    pwzCloudName: pointer
    dwScope: uint32
    dwCloudFlags: uint32
    pwzGroupPeerName: pointer
    pwzIssuerPeerName: pointer
    pwzSubjectPeerName: pointer
    pwzGroupFriendlyName: pointer
    pwzIssuerFriendlyName: pointer
    pwzSubjectFriendlyName: pointer
    ftValidityStart: FILETIME
    ftValidityEnd: FILETIME
    cRoles: uint32
    pRoles: pointer
    cClassifiers: uint32
    ppwzClassifiers: pointer
    pSubjectPublicKey: pointer
    authScheme: int32

struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct PEER_INVITATION_INFO
{
    uint dwSize;
    uint dwFlags;
    void* pwzCloudName;
    uint dwScope;
    uint dwCloudFlags;
    void* pwzGroupPeerName;
    void* pwzIssuerPeerName;
    void* pwzSubjectPeerName;
    void* pwzGroupFriendlyName;
    void* pwzIssuerFriendlyName;
    void* pwzSubjectFriendlyName;
    FILETIME ftValidityStart;
    FILETIME ftValidityEnd;
    uint cRoles;
    void* pRoles;
    uint cClassifiers;
    void* ppwzClassifiers;
    void* pSubjectPublicKey;
    int authScheme;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PEER_INVITATION_INFO サイズ: 84 バイト(x86)
dim st, 21    ; 4byte整数×21(構造体サイズ 84 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pwzCloudName : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwScope : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwCloudFlags : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pwzGroupPeerName : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; pwzIssuerPeerName : LPWSTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; pwzSubjectPeerName : LPWSTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; pwzGroupFriendlyName : LPWSTR (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; pwzIssuerFriendlyName : LPWSTR (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; pwzSubjectFriendlyName : LPWSTR (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ftValidityStart : FILETIME (+44, 8byte)  varptr(st)+44 を基点に操作(8byte:入れ子/配列)
; ftValidityEnd : FILETIME (+52, 8byte)  varptr(st)+52 を基点に操作(8byte:入れ子/配列)
; cRoles : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; pRoles : GUID* (+64, 4byte)  varptr(st)+64 を基点に操作(4byte:入れ子/配列)
; cClassifiers : DWORD (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; ppwzClassifiers : LPWSTR* (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; pSubjectPublicKey : CERT_PUBLIC_KEY_INFO* (+76, 4byte)  varptr(st)+76 を基点に操作(4byte:入れ子/配列)
; authScheme : PEER_GROUP_AUTHENTICATION_SCHEME (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PEER_INVITATION_INFO サイズ: 136 バイト(x64)
dim st, 34    ; 4byte整数×34(構造体サイズ 136 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pwzCloudName : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; dwScope : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwCloudFlags : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; pwzGroupPeerName : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; pwzIssuerPeerName : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pwzSubjectPeerName : LPWSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; pwzGroupFriendlyName : LPWSTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; pwzIssuerFriendlyName : LPWSTR (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; pwzSubjectFriendlyName : LPWSTR (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ftValidityStart : FILETIME (+72, 8byte)  varptr(st)+72 を基点に操作(8byte:入れ子/配列)
; ftValidityEnd : FILETIME (+80, 8byte)  varptr(st)+80 を基点に操作(8byte:入れ子/配列)
; cRoles : DWORD (+88, 4byte)  st.22 = 値  /  値 = st.22   (lpoke/lpeek も可)
; pRoles : GUID* (+96, 8byte)  varptr(st)+96 を基点に操作(8byte:入れ子/配列)
; cClassifiers : DWORD (+104, 4byte)  st.26 = 値  /  値 = st.26   (lpoke/lpeek も可)
; ppwzClassifiers : LPWSTR* (+112, 8byte)  qpoke st,112,値 / qpeek(st,112)  ※IronHSPのみ。3.7/3.8は lpoke st,112,下位 : lpoke st,116,上位
; pSubjectPublicKey : CERT_PUBLIC_KEY_INFO* (+120, 8byte)  varptr(st)+120 を基点に操作(8byte:入れ子/配列)
; authScheme : PEER_GROUP_AUTHENTICATION_SCHEME (+128, 4byte)  st.32 = 値  /  値 = st.32   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global PEER_INVITATION_INFO
    #field int dwSize
    #field int dwFlags
    #field intptr pwzCloudName
    #field int dwScope
    #field int dwCloudFlags
    #field intptr pwzGroupPeerName
    #field intptr pwzIssuerPeerName
    #field intptr pwzSubjectPeerName
    #field intptr pwzGroupFriendlyName
    #field intptr pwzIssuerFriendlyName
    #field intptr pwzSubjectFriendlyName
    #field FILETIME ftValidityStart
    #field FILETIME ftValidityEnd
    #field int cRoles
    #field intptr pRoles
    #field int cClassifiers
    #field intptr ppwzClassifiers
    #field intptr pSubjectPublicKey
    #field int authScheme
#endstruct

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

PEER_INVITATION_INFO

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義