API 関数のグループ化

[アーティクル]
03/13/2025

グループ化 API では、次の関数を使用します。

グループ初期化およびクリーンアップ関数

機能	形容
PeerGroupShutdownの	PeerGroupStartup で作成されたピアグループを閉じ、割り当てられたリソースをすべて破棄します。
PeerGroupStartupの	要求されたバージョンのピアインフラストラクチャを使用してピアグループを開始します。

グループ作成およびアクセス関数

機能	形容
PeerGroupClose	PeerGroupCreate、PeerGroupJoin、または PeerGroupOpen関数の以前の呼び出しによって取得されたピアグループハンドル無効にします。
PeerGroupConnect	ピアグループの PNRP 検索を開始し、そのグループへの接続を試みます。この関数が正常に呼び出されると、ピアはピアグループの他のメンバーと通信できます。
PeerGroupConnectByAddress	既知の IPv6 アドレスを持つ他のピアが参加しているピアグループへの接続を試みます。
PeerGroupCreate	新しいピアグループを作成します。
PeerGroupCreateInvitation	指定したピアがグループに参加するために使用できる XML 文字列を返します。
PeerGroupCreatePasswordInvitationの	指定したピアが、一致するパスワードでグループを結合するために使用できる XML 文字列を返します。
PeerGroupDelete	ピアグループに関連付けられているローカルデータと証明書を削除します。
PeerGroupGetStatus	グループの現在の状態を取得します。
PeerGroupIssueCredentials	GMC を含む資格情報を特定の ID に発行し、必要に応じて、招待されたピアがピアグループへの参加に使用できる招待 XML 文字列を返します。
PeerGroupJoin	招待を持つピアが既存のピアグループに参加できるようにします。
PeerGroupOpen	ピアが作成または参加したピアグループを開きます。
PeerGroupParseInvitationの	特定の招待の詳細を含む PEER_INVITATION_INFO 構造体を返します。
PeerGroupPasswordJoin	招待と正しいパスワードを持つピアが、パスワードで保護されたピアグループに参加できるようにします。

グループおよびメンバー情報関数

機能	形容
PeerGroupEnumMembers	使用可能なピアグループメンバーと関連するメンバーシップ情報の列挙体を作成します。
PeerGroupGetPropertiesの	指定したグループのプロパティに関する情報を取得します。
PeerGroupSetPropertiesの	現在のピアグループのプロパティを設定します。この API のバージョン 1.0 では、ピアグループの作成者のみがこの操作を実行できます。

レコードおよびレコード管理機能

機能	形容
PeerGroupAddRecord	ピアグループに新しいレコードを追加します。このレコードは、参加しているすべてのピアに伝達されます。
PeerGroupDeleteRecord	ピアグループからレコードを削除します。レコードを削除できるのは、レコードの作成者だけです。
PeerGroupEnumRecords	ピアグループレコードの列挙を作成します。
PeerGroupGetRecord	特定のグループレコードを取得します。
PeerGroupSearchRecords	指定された条件に一致するレコードをローカルピアグループデータベースで検索します。
PeerGroupUpdateRecord	特定のピアグループ内のレコードを更新します。

グループデータベースのインポート/エクスポート関数

機能	形容
PeerGroupExportDatabaseの	ピアグループデータベースを特定のファイルにエクスポートします。これを別のコンピューターに転送し、PeerGroupImportDatabase 関数を使用してインポートできます。
PeerGroupImportDatabaseの	ローカルファイルからピアグループデータベースをインポートします。

直接接続関数

機能	形容
PeerGroupCloseDirectConnectionの	2 つのピア間の特定の直接接続を閉じます。
PeerGroupEnumConnectionsの	ピアで現在アクティブな接続の列挙体を作成します。
PeerGroupOpenDirectConnection	ピアグループ内の別のピアとの直接接続を確立します。
PeerGroupSendDataの	近隣接続または直接接続経由でメンバーにデータを送信します。

グループイベントインフラストラクチャ

機能	形容
PeerGroupGetEventDataの	アプリケーションがグループ化イベントによって返されるデータを取得できるようにします。
PeerGroupRegisterEvent	特定のピアグループイベントのピアを登録します。
PeerGroupUnregisterEventの	指定されたイベントハンドルに関連付けられているピアイベントの通知からピアの登録を解除します。

グループ時間変換関数

機能	形容
PeerGroupPeerTimeToUniversalTime	ピアグループで管理される参照時刻の値を、ピアコンピューターでの表示に適したローカライズされた時刻値に変換します。
PeerGroupUniversalTimeToPeerTime	ローカル時刻の値をピアのコンピューターから共通のピアグループ時間値に変換します。

グループ構成関数

機能	形容
PeerGroupExportConfigの	ピアのグループ構成を、ID、グループ名、および ID の GMC を含む XML 文字列としてエクスポートします。
PeerGroupImportConfigの	指定された XML 構成文字列の特定の設定に基づいて、ID のピアグループ構成をインポートします。