PeerGroupUpdateRecord 函式 (p2p.h)

  • 發行項

PeerGroupUpdateRecord函式會更新特定對等群組內的記錄。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupUpdateRecord(
  [in] HGROUP       hGroup,
  [in] PPEER_RECORD pRecord
);

參數

[in] hGroup

處理已更新其記錄的對等群組。 PeerGroupCreate、PeerGroupOpen或PeerGroupJoin函式會傳回此控制碼。 此為必要參數。

[in] pRecord

包含hGroup更新記錄之PEER_RECORD結構的指標。 此為必要參數。

PEER_RECORD中的下列成員可以更新。

  • pwzAttributes
  • ftExpiration
  • data
PEER_RECORD中的下列成員必須存在，但無法變更。
  • dwSize
  • id
  • type
  • dwFlags
如果填入，則會忽略下列成員。
  • dwVersion
  • pwzCreatorId
  • pwzModifiedById
  • ftCreation
  • ftLastModified
  • securityData
保留的成員是選擇性的。

傳回值

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

傳回碼 描述
E_INVALIDARG
 其中一個指定的參數無效。
PEER_E_GROUP_NOT_READY
 對等群組不是可以更新記錄的狀態，例如，已呼叫 PeerGroupJoin ，但與對等群組資料庫同步處理尚未完成。
PEER_E_INVALID_GROUP
 對等群組的控制碼無效。
PEER_E_NOT_AUTHORIZED
 目前的對等身分識別沒有刪除記錄的授權。 在此情況下，對等身分識別不是記錄的建立者。
PEER_E_RECORD_NOT_FOUND
 記錄不能位於資料存放區中。
 

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

需求

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

另請參閱

PEER_RECORD

PeerGroupAddRecord

PeerGroupCreate

PeerGroupDeleteRecord

PeerGroupJoin

PeerGroupOpen