PeerGroupGetRecord 函式 (p2p.h)

發行項
08/25/2023

PeerGroupGetRecord 函式會擷取特定的群組記錄。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
  [in]  HGROUP       hGroup,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

參數

[in] hGroup

包含特定記錄的群組控制碼。 PeerGroupCreate、PeerGroupOpen或PeerGroupJoin函式會傳回此控制碼。此為必要參數。

[in] pRecordId

指定 GUID 值，這個值可唯一識別對等群組內的必要記錄。此為必要參數。

[out] ppRecord

包含傳回記錄之 PEER_RECORD 結構的位址指標。這個結構是透過將其指標傳遞至 PeerFreeData來釋出。此為必要參數。

傳回值

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

傳回碼	描述
E_INVALIDARG	其中一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行指定的作業。
PEER_E_GROUP_NOT_READY	對等群組不在可擷取群組記錄的狀態。例如，呼叫 PeerGroupJoin ，但尚未完成與對等群組資料庫的同步處理。
PEER_E_INVALID_GROUP	對等群組的控制碼無效。
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