PeerGraphConnect 함수(p2p.h)
PeerGraphConnect 함수는 피어 그래프에서 지정된 노드에 연결하려고 시도합니다. 이 함수는 비동기 작업을 시작합니다. 호출 애플리케이션은 연결 시도가 성공했는지 확인하기 위해 PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION 이벤트를 기다려야 합니다.
구문
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphConnect(
[in] HGRAPH hGraph,
[in] PCWSTR pwzPeerId,
[in] PPEER_ADDRESS pAddress,
[out] ULONGLONG *pullConnectionId
);
매개 변수
[in] hGraph
피어 그래프에 대한 핸들입니다.
[in] pwzPeerId
pAddress에서 연결할 피어의 고유 ID입니다. NULL을 지정하여 동일한 피어 그래프의 지정된 주소에서 수신 대기하는 모든 피어에 연결합니다.
[in] pAddress
연결할 노드를 식별하는 PEER_ADDRESS 구조체에 대한 포인터입니다.
[out] pullConnectionId
연결 ID가 포함된 ULONGLONG 에 대한 포인터를 받습니다. 이 ID는 직접 통신 함수와 함께 사용할 수 있습니다.
반환 값
함수 호출이 성공하면 반환 값이 S_OK. 그렇지 않으면 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
매개 변수 중 하나가 잘못되었습니다. |
|
지정된 작업을 수행하기에 충분한 메모리가 없습니다. |
|
지정된 노드에 대한 인접 연결이 이미 있습니다. |
|
피어 그래프에 대한 핸들이 잘못되었습니다. |
|
이 함수를 사용하기 전에 PeerGraphStartup 을 호출하여 그래프를 초기화해야 합니다. |
요구 사항
| 지원되는 최소 클라이언트 | WINDOWS XP SP2 [데스크톱 앱만 해당],Windows XP SP1 및 고급 네트워킹 팩 forWindows XP |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | p2p.h |
| 라이브러리 | P2PGraph.lib |
| DLL | P2PGraph.dll |