PEER_GRAPH_PROPERTIES 結構 (p2p.h)
PEER_GRAPH_PROPERTIES結構包含對等圖形、標識符、範圍和其他資訊原則的相關數據。
語法
typedef struct peer_graph_properties_tag {
DWORD dwSize;
DWORD dwFlags;
DWORD dwScope;
DWORD dwMaxRecordSize;
PWSTR pwzGraphId;
PWSTR pwzCreatorId;
PWSTR pwzFriendlyName;
PWSTR pwzComment;
ULONG ulPresenceLifetime;
ULONG cPresenceMax;
} PEER_GRAPH_PROPERTIES, *PPEER_GRAPH_PROPERTIES;
成員
dwSize
指定這個數據結構的大小，以位元組為單位。 呼叫 PeerGraphCreate 之前，dwSize 成員必須設定為PEER_GRAPH_PROPERTIES的大小。 這是必要成員。 沒有預設值。
dwFlags
旗標，控制圖形中對等的行為。 預設值未設定旗標。 下表識別出有效的值。
| 值 | Description |
|---|---|
| PEER_GRAPH_PROPERTY_DEFER_EXPIRATION | 指定何時到期圖表記錄。 當圖形未連接且設定此旗標時，在圖形連線到至少一個其他成員之前，才會發生到期。 |
dwScope
指定發佈對等圖形標識碼的範圍。 預設值為全域。 下表會識別有效的值。
| 值 | Description |
|---|---|
| PEER_GRAPH_SCOPE_GLOBAL | 範圍包括因特網。 |
| PEER_GRAPH_SCOPE_LINK_LOCAL | 範圍限制為本機子網。 |
| PEER_GRAPH_SCOPE_SITE_LOCAL | 範圍僅限於網站，例如公司內部網路。 |
dwMaxRecordSize
指定值，這個值表示可加入對等圖形的最大記錄。 有效值為零 (0) ，表示預設的最大記錄大小會 (60 MB) 使用，以及介於 1024 個字節和 60 MB 之間的任何值。
pwzGraphId
指定對等圖形的唯一標識碼。 此標識碼必須是計算機/使用者配對的唯一標識碼。 這個成員是必要的，而且沒有預設值。 如果字串值大於 256 個字元， (包括 null 終止符) ，則會傳回錯誤。
pwzCreatorId
指定對等圖形建立者的唯一標識符。 這個成員是必要的，而且沒有預設值。 如果字串值大於 256 個字元， (包括 null 終止符) ，則會傳回錯誤。
pwzFriendlyName
指定對等圖形的易記名稱。 這個成員是選擇性的，而且可以是 NULL。 預設值是 NULL。 此字串的最大長度為 256 個字元，包括 Null 終止符。
pwzComment
指定用來描述對等圖形的批注。 這個成員是選擇性的，而且可以是 NULL。 預設值是 NULL。 此字串的最大長度為 512 個字元，包括 Null 終止符。
ulPresenceLifetime
指定目前狀態記錄到期之前的秒數。 預設值為 300 秒 (5 分鐘)。 請勿將 ulPresenceLifetime 的值設定為小於 300 秒。 如果此成員設定小於 300 (5 分鐘) 預設值，則可能發生未定義的行為。
cPresenceMax
指定對等基礎結構一次保留在對等圖形中的目前狀態記錄數目。 具有其目前狀態的節點可由具有 PeerGraphEnumNodes 的所有其他節點列舉。 指定下表中所識別的其中一個值，以指定使用者的目前狀態記錄發佈方式。
| 值 | 說明 |
|---|---|
| -1 | 目前狀態記錄會自動發佈給所有使用者。 |
| 0 | 目前狀態記錄不會自動發佈。 |
| 1-N | 最多 N 筆目前狀態記錄會一次發佈。 對等圖形基礎結構會隨機選擇發佈的目前狀態記錄。 |
備註
應用程式可以使用 PeerGraphSetPresence強制對等圖形基礎結構發佈目前狀態資訊。
呼叫 PeerGraphSetProperties 時，只能更新PEER_GRAPH_PROPERTIES中的特定字段。 可以更新下列成員：
- pwzFriendlyName
- pwzComment
- ulPresenceLifetime
- cPresenceMax
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 標頭 | p2p.h |