PEER_GROUP_PROPERTIES結構 (p2p.h)
PEER_GROUP_PROPERTIES結構包含對等群組成員資格原則的相關數據。
語法
typedef struct peer_group_properties_tag {
DWORD dwSize;
DWORD dwFlags;
PWSTR pwzCloud;
PWSTR pwzClassifier;
PWSTR pwzGroupPeerName;
PWSTR pwzCreatorPeerName;
PWSTR pwzFriendlyName;
PWSTR pwzComment;
ULONG ulMemberDataLifetime;
ULONG ulPresenceLifetime;
DWORD dwAuthenticationSchemes;
PWSTR pwzGroupPassword;
PEER_ROLE_ID groupPasswordRole;
} PEER_GROUP_PROPERTIES, *PPEER_GROUP_PROPERTIES;
成員
dwSize
結構的大小，以位元組為單位。
dwFlags
描述 對等群組行為的PEER_GROUP_PROPERTY_FLAGS旗標。 默認值為零 (0) ，表示未設定旗標。
pwzCloud
指定對等群組參與的對等名稱解析通訊協定 (PNRP) 雲端。 如果這個成員是 NULL，則預設值為 「global」。。
pwzClassifier
指定分類器，用來識別對等群組對等名稱的授權單位，以在 PNRP 雲端內註冊或解析。 此欄位的大小上限為 149 Unicode 字元。 此成員可以是 NULL。
pwzGroupPeerName
指定向 PNRP 服務註冊的對等組名稱。 此欄位的大小上限為 137 個 Unicode 字元。
pwzCreatorPeerName
指定與對等群組建立者相關聯的對等名稱。 此欄位的大小上限為 137 個 Unicode 字元。 如果這個結構成員為 NULL，實作會使用從 PeerIdentityGetDefault 取得的身分識別。
pwzFriendlyName
指定對等群組的易記 (顯示) 名稱。 此欄位的大小上限為 255 個字元。
pwzComment
包含用來描述對等群組的批注。 此欄位的大小上限為 255 個字元。
ulMemberDataLifetime
指定對等群組成員數據的存留期，以秒為單位 (PEER_MEMBER) 。 此欄位的最小值為 8 小時，最大值為 10 年。 默認值為 2,419,200 秒或 28 天。
如果此值設定為零 (0) ，則成員數據具有允許的存留期上限，這是發出成員認證之系統管理員存留期內剩餘的時間。
ulPresenceLifetime
指定發行至對等群組之目前狀態資訊的存留期，以秒為單位。 預設值為 300 秒。 請勿將 ulPresenceLifetime 的值設定為小於 300 秒。 如果這個成員設定為小於 300 秒的預設值，則可能發生未定義的行為。
dwAuthenticationSchemes
Windows Vista 或更新版本。 PEER_GROUP_AUTHENTICATION_SCHEME列舉值的邏輯 OR，指出對等群組支援的驗證類型。
pwzGroupPassword
Windows Vista 或更新版本。 Unicode 字串的指標，其中包含用來驗證嘗試加入對等群組之對等的密碼。
groupPasswordRole
Windows Vista 或更新版本。 GUID 值，指出驗證需要密碼的對等群組角色。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 標頭 | p2p.h |