API 関数のグループ化

[アーティクル]
06/13/2023

Grouping 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 のピアグループ構成をインポートします。