API 関数のグループ化

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