PeerGroupAddRecord 函式 (p2p.h)

PeerGroupAddRecord 函式會將新的記錄新增至對等群組，這會傳播至所有參與的對等。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupAddRecord(
  [in]  HGROUP       hGroup,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

[in] hGroup

對等群組的句柄。這個句柄是由 PeerGroupCreate、PeerGroupOpen 或 PeerGroupJoin 函式傳回。此為必要參數。

[in] pRecord

PEER_RECORD結構的指標，該結構會新增至 hGroup 中指定的對等群組。此為必要參數。

必須填入 PEER_RECORD 中的下列成員。

ftExpiration 必須以對等時間表示， (請參閱 PeerGroupUniversalTimeToPeerTime) 。

如果填入，則會忽略並覆寫下列成員。

其餘欄位是選擇性的。

[out] pRecordId

識別記錄之 GUID 的指標。此為必要參數。

如果函式成功，則傳回S_OK。否則，函式會傳回下列其中一個值。

傳回碼	Description
E_INVALIDARG	其中一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行指定的作業。
PEER_E_GROUP_NOT_READY	對等群組不是可以新增記錄的狀態。例如，呼叫PeerGroupJoin ，但尚未完成與對等群組資料庫的同步處理。
PEER_E_INVALID_ATTRIBUTES	XML 字串，其中包含PEER_RECORD結構之 pwzAttributes 成員中的記錄屬性不符合架構規格。
PEER_E_INVALID_GROUP	對等群組的句柄無效。
PEER_E_INVALID_PEER_NAME	提供的對等名稱無效。
PEER_E_INVALID_RECORD	PEER_RECORD中的一或多個字段無效。
PEER_E_MAX_RECORD_SIZE_EXCEEDED	記錄已超過對等群組屬性所允許的大小上限。
PEER_E_NOT_AUTHORIZED	身分識別未獲授權發佈該類型的記錄。

密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。

需求	值
最低支援的用戶端	Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件
最低支援的伺服器	都不支援
目標平台	Windows
標頭	p2p.h
程式庫	P2P.lib
Dll	P2P.dll