peerGroupSetProperties 函式 (p2p.h)
PeerGroupSetProperties 函式會設定目前的對等群組屬性。 在此 API 1.0 版中，只有對等群組的建立者可以執行這項作業。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSetProperties(
[in] HGROUP hGroup,
[in] PPEER_GROUP_PROPERTIES pProperties
);
參數
[in] hGroup
處理由對等設定其屬性的對等群組。 這個句柄是由 PeerGroupCreate、PeerGroupOpen 或 PeerGroupJoin 函式傳回。 此為必要參數。
[in] pProperties
包含新屬性的對等填入 PEER_GROUP_PROPERTIES 結構的指標。 若要取得此結構，對等必須先呼叫 PeerGroupGetProperties、變更適當的欄位，然後將它當做此參數傳遞。 此為必要參數。
無法變更 下列PEER_GROUP_PROPERTIES 成員：
- dwSize
- pwzCloud
- pwzClassifier
- pwzGroupPeerName
- pwzCreatorPeerName
傳回值
如果作業成功，則傳回 S_OK 。 否則，函式會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
記憶體不足，無法完成作業。 |
|
群組不是可以設定對等群組屬性的狀態。 例如，已呼叫 PeerGroupJoin ，但與對等群組資料庫的同步處理尚未完成。 |
|
對等群組的句柄無效。 |
|
一或多個指定的屬性無效。 |
|
目前的身分識別沒有變更這些屬性的授權。 在此情況下，身分識別不是對等群組的建立者。 |
|
指定的密碼不符合系統密碼需求。 |
密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。
備註
對於使用密碼的應用程式，建議藉由呼叫 CryptoProtectMemory 和 SecureZeroMemory 函式安全地處理密碼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |