peerGroupGetProperties 函式 (p2p.h)
PeerGroupGetProperties 函式會擷取指定群組屬性的相關信息。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
[in] HGROUP hGroup,
[out] PPEER_GROUP_PROPERTIES *ppProperties
);
參數
[in] hGroup
處理至擷取其屬性的對等群組。 這個句柄是由 PeerGroupCreate、PeerGroupOpen 或 PeerGroupJoin 函式傳回。 此為必要參數。
[out] ppProperties
包含對等群組屬性相關信息 之PEER_GROUP_PROPERTIES 結構的指標。 此數據必須使用 PeerFreeData釋放。 此為必要參數。
傳回值
如果作業成功，則傳回 S_OK 。 否則，函式會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
其中一個參數無效。 |
|
記憶體不足，無法執行指定的作業。 |
|
群組不是可以擷取對等群組屬性的狀態。 例如， 呼叫PeerGroupJoin ，但尚未完成與群組資料庫的同步處理。 |
|
對等群組的句柄無效。 |
密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。
備註
如果對等尚未與對等群組資料庫同步處理，則無法擷取群組屬性。 若要在呼叫此函式之前先與對等群組資料庫同步處理，請先呼叫 PeerGroupConnect。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |