群組 API 函式
群組 API 會使用下列函式：
群組初始化和清除函式
| 功能 | 描述 |
|---|---|
| PeerGroupShutdown | 關閉使用peerGroupStartup 建立的對等群組， 並處置任何已配置的資源。 |
| PeerGroupStartup | 使用要求的對等基礎結構版本來起始對等群組。 |
群組建立和存取函式
| 功能 | 描述 |
|---|---|
| PeerGroupClose | 使先前呼叫 peerGroupCreate、PeerGroupJoin或 PeerGroupOpen 函式所取得的對等群組句柄失效。 |
| PeerGroupConnect | 起始對等群組的 PNRP 搜尋，並嘗試連線到該群組。 成功呼叫此函式之後，對等可以與對等群組的其他成員通訊。 |
| PeerGroupConnectByAddress | 嘗試連線到其他具有已知 IPv6 位址的對等群組參與。 |
| PeerGroupCreate | 建立新的對等群組。 |
| PeerGroupCreateInvitation | 傳回 XML 字串，這個字串可由指定的對等用來聯結群組。 |
| PeerGroupCreatePasswordInvitation | 傳回 XML 字串，這個字串可由指定的對等用來聯結具有相符密碼的群組。 |
| PeerGroupDelete | 刪除與對等群組相關聯的本機數據和憑證。 |
| PeerGroupGetStatus | 擷取群組的目前狀態。 |
| PeerGroupIssueCredentials | 對特定身分識別發出認證，包括 GMC，並選擇性地傳回邀請 XML 字串，受邀的對等可用來加入對等群組。 |
| PeerGroupJoin | 允許邀請的對等加入現有的對等群組。 |
| PeerGroupOpen | 開啟對等已建立或加入的對等群組。 |
| PeerGroupParseInvitation | 傳回具有特定邀請詳細數據的 PEER_INVITATION_INFO 結構。 |
| PeerGroupPasswordJoin | 允許具有邀請的對等和正確的密碼加入受密碼保護的對等群組。 |
群組和成員資訊函式
| 功能 | 描述 |
|---|---|
| PeerGroupEnumMembers | 建立可用對等群組成員和相關聯成員資格資訊的列舉。 |
| PeerGroupGetProperties | 擷取指定群組屬性的相關信息。 |
| PeerGroupSetProperties | 設定目前的對等群組屬性。 在此 API 1.0 版中，只有對等群組的建立者可以執行這項作業。 |
記錄和記錄管理功能
| 功能 | 描述 |
|---|---|
| PeerGroupAddRecord | 將新記錄新增至對等群組，該群組會傳播至所有參與的對等。 |
| PeerGroupDeleteRecord | 從對等群組刪除記錄。 只有記錄的建立者可以刪除它。 |
| PeerGroupEnumRecords | 建立對等群組記錄的列舉。 |
| PeerGroupGetRecord | 擷取特定群組記錄。 |
| PeerGroupSearchRecords | 搜尋本機對等群組資料庫，以取得符合所提供準則的記錄。 |
| PeerGroupUpdateRecord | 更新特定對等群組內的記錄。 |
群組資料庫匯入/匯出函式
| 功能 | 描述 |
|---|---|
| PeerGroupExportDatabase | 將對等群組資料庫導出至特定檔案，該檔案可以傳輸至另一部計算機，並使用 PeerGroupImportDatabase 函式匯入。 |
| PeerGroupImportDatabase | 從本機檔案匯入對等群組資料庫。 |
直接連接函式
| 功能 | 描述 |
|---|---|
| PeerGroupCloseDirectConnection | 關閉兩個對等之間的特定直接連線。 |
| PeerGroupEnumConnections | 建立對等上目前作用中的連線列舉。 |
| PeerGroupOpenDirectConnection | 與對等群組中的另一個對等建立直接連線。 |
| PeerGroupSendData | 透過鄰近或直接連接將數據傳送至成員。 |
群組事件基礎結構
| 功能 | 描述 |
|---|---|
| PeerGroupGetEventData | 允許應用程式擷取群組事件傳回的數據。 |
| PeerGroupRegisterEvent | 註冊特定對等群組事件的對等。 |
| PeerGroupUnregisterEvent | 從與所提供事件句柄相關聯之對等事件的通知取消註冊對等。 |
群組時間轉換函式
| 功能 | 描述 |
|---|---|
| PeerGroupPeerTimeToUniversalTime | 將對等群組維護的參考時間值轉換為適合在對等計算機上顯示的當地語系化時間值。 |
| PeerGroupUniversalTimeToPeerTime | 將本地時間值從對等計算機轉換成一般對等群組時間值。 |
群組組態函式
| 功能 | 描述 |
|---|---|
| PeerGroupExportConfig | 將對等的群組組態匯出為 XML 字串，其中包含身分識別的身分識別、組名和 GMC。 |
| PeerGroupImportConfig | 根據提供的 XML 組態字串中的特定設定，匯入身分識別的對等群組組態。 |