共用方式為

PEER_EVENT_CONNECTION_CHANGE_DATA結構（p2p.h）

若觸發以下對等事件之一， PEER_GRAPH_EVENT_DATA 結構指向 PEER_EVENT_CONNECTION_CHANGE_DATA 結構：

  • PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION
  • PEER_GRAPH_EVENT_DIRECT_CONNECTION
  • PEER_GROUP_EVENT_NEIGHBOR_CONNECTION
  • PEER_GROUP_EVENT_DIRECT_CONNECTION
PEER_EVENT_CONNECTION_CHANGE_DATA結構包含更新資訊，包含鄰居或直接連線的變更。

語法

typedef struct peer_event_connection_change_data_tag {
  DWORD                  dwSize;
  PEER_CONNECTION_STATUS status;
  ULONGLONG              ullConnectionId;
  ULONGLONG              ullNodeId;
  ULONGLONG              ullNextConnectionId;
  HRESULT                hrConnectionFailedReason;
} PEER_EVENT_CONNECTION_CHANGE_DATA, *PPEER_EVENT_CONNECTION_CHANGE_DATA;

Members

dwSize

指定結構的大小。

status

指定鄰居或直接連接的變化類型。 有效的數值如下。

價值觀 Meaning
PEER_CONNECTED
 已建立新的進出連線至本地節點。
PEER_CONNECTION_FAILED
 嘗試連接本地節點失敗。

一次連線嘗試可能導致多次連線失敗。 這會在初次連線失敗後發生，當對等基礎設施將 ullNextConnectionId 成員設定為節點 ID 並嘗試重新連線時。 若 ullNextConnectionId 成員為 0，則不會再嘗試連接。
PEER_DISCONNECTED
 現有的連線已被切斷。

ullConnectionId

指定變更連線的唯一 ID。

ullNodeId

指定變更節點的唯一 ID。

ullNextConnectionId

Windows Vista 或更新版本。 包含下一個可用的節點 ID，當連線失敗時，群組或圖形 API 將嘗試連接該節點。 若該成員值為 0，則不會嘗試進一步連接。

hrConnectionFailedReason

Windows Vista 或更新版本。 指定連線失敗時的錯誤類型。 hrConnectionFailedReason 可以回傳以下錯誤代碼。

價值觀 Description
PEER_E_CONNECTION_REFUSED 連線已建立但被拒絕。 遠端節點已經達到最大連線數，或已有連線存在。
PEER_E_CONNECTION_FAILED 嘗試連接遠端節點失敗。
PEER_E_CONNECTION_NOT_AUTHENTICATED 在認證階段會失去連線。 這是因為網路故障或遠端節點斷開連線所致。

需求

Requirement 價值觀
最低支援的用戶端 Windows XP 搭配 SP2 [僅限桌面應用程式]，Windows XP 搭配 SP1 搭配 Windows XP 進階網路套件
支援的最低伺服器 不支援
Header P2P.H

另請參閱

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA

  • Last updated on