共用方式為

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;

成員

dwSize

指定 結構的大小。

status

指定鄰近或直接連線中的變更類型。 有效值為下列各項。

值 意義
PEER_CONNECTED
 已建立本機節點的新傳入或傳出連線。
PEER_CONNECTION_FAILED
 嘗試連線到本機節點失敗。

單一嘗試連線可能會導致多個連線失敗。 當對等基礎結構將 ullNextConnectionId 成員設定為節點識別碼並嘗試新的連線時，就會在初始連線失敗之後發生。 如果 ullNextConnectionId 成員為 0，將不會嘗試進一步連線。
PEER_DISCONNECTED
 現有的連線已中斷連線。

ullConnectionId

指定已變更之連線的唯一識別碼。

ullNodeId

指定已變更之節點的唯一識別碼。

ullNextConnectionId

Windows Vista 或更新版本。 包含群組或圖形 API 在連線失敗時嘗試連線到的下一個可用節點識別碼。 如果此成員的值為 0，將不會嘗試進一步連線。

hrConnectionFailedReason

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

值 描述
PEER_E_CONNECTION_REFUSED 已建立並拒絕連線。 遠端節點已達到連線數目上限，或連線已存在。
PEER_E_CONNECTION_FAILED 嘗試連線到遠端節點失敗。
PEER_E_CONNECTION_NOT_AUTHENTICATED 在驗證階段期間，連線會遺失。 這是網路失敗或遠端節點中斷連線的結果。

需求

   
最低支援的用戶端 Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用于Windows XP 的進階網路套件
最低支援的伺服器 都不支援
標頭 p2p.h

另請參閱

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA