共用方式為


群組 API 函式

群組 API 會使用下列函式:

群組初始化和清除函式

函式 描述
PeerGroupShutdown 關閉以 PeerGroupStartup 建立的對等群組,並處置任何已配置的資源。
PeerGroupStartup 使用要求的對等基礎結構版本來起始對等群組。

 

群組建立和存取函式

函式 描述
PeerGroupClose 使先前呼叫 PeerGroupCreatePeerGroupJoinPeerGroupOpen 函式取得的對等群組控制碼失效。
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 組態字串中的特定設定,匯入身分識別的對等群組組態。