PeerCollabSignin 함수는 피어를 호스트된 인터넷(서버리스 프레즌스) 또는 서브넷("사람 Near Me") 피어 협업 네트워크 프레즌스 공급자에 서명합니다.
구문
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSignin(
[in] HWND hwndParent,
[in] DWORD dwSigninOptions
);
매개 변수
[in] hwndParent
부모 애플리케이션 로그인에 대한 Windows 핸들입니다.
[in] dwSigninOptions
PEER_SIGNIN_FLAGS 호출 피어에 대한 현재 상태 공급자 로그인 옵션이 포함된 열거형 값입니다.
반환 값
함수가 성공하면 S_OK 반환합니다. 그렇지 않으면 함수는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
이 작업을 지원하기에 충분한 메모리가 없습니다. |
|
인수 중 하나가 잘못되었습니다. |
|
애플리케이션이 PeerCollabStartup에 대한 이전 호출을 수행하지 않았습니다. |
|
관리자 권한 프로세스에서 PeerCollabSignIn 을 호출하려고 했습니다. |
|
로그인에 성공했지만 지금은 IPv6 주소를 사용할 수 없습니다. |
설명
p2phost.exe 서비스가 실행되고 있지 않으면 이 함수가 시작됩니다.
관리자 권한 프로세스에서 p2phost.exe 서비스를 시작하려고 하면 오류가 반환됩니다. 결과적으로 p2phost.exe 관리 권한을 실수로 부여한 애플리케이션에서 보안을 손상할 수 없습니다. 들어오는 초대에 대한 Windows 대화 상자를 표시해야 하므로 비대화형 모드에서 p2phost.exe 시작할 수 없습니다.
PeerCollabSignin을 호출하면 사용자가 자동 로그인에 권한을 부여하지 않은 경우 로그인 사용자 인터페이스가 표시됩니다. hwndParent를 지정하면 사용자 인터페이스 창에서 hwndParent를 부모 창으로 사용합니다.
사용자가 "사람 Near Me"에 로그인하면 사용자의 표시 이름, 컴퓨터 이름 및 IP 주소가 서브넷의 피어에 게시됩니다. 사용자는 필요에 따라 게시를 위해 표시 사진을 지정할 수 있습니다. PeerCollabSignin이 호출되지 않거나 사용자가 로그아웃하는 경우 이 정보는 게시되지 않습니다.
로그인하면 사용자는 서브넷에 로그인되어 상호 작용에 사용할 수 있는 피어 목록을 볼 수 있습니다. 다른 사람이 서브넷에서 "가까운 사람"에 로그인하지 않은 경우 이 목록은 비어 있습니다.
여러 애플리케이션이 지정된 순간에 인프라를 사용할 수 있습니다. 다른 애플리케이션은 인프라를 사용할 수 없으므로 단일 애플리케이션에서 PeerCollabSignout을 호출하는 것은 권장되지 않습니다. 또한 애플리케이션은 사용자 로그인 및 로그아웃 또는 컴퓨터가 절전 모드 또는 최대 절전 모드로 전환되는 상황을 처리할 수 있도록 준비해야 합니다.
PeerCollabSignin 함수를 완료하려면 현재 최대 2초가 필요합니다.
표시 이름은 반드시 고유 하지 않습니다. 사용자는 상호 작용 초대를 수락하기 전에 전자 메일, 전화 또는 직접 표시 이름을 사용하는 사람의 ID를 확인해야 합니다.
피어 협업 네트워크에서 로그아웃하려면 동일한 로그인 옵션 집합으로 PeerCollabSignout 을 호출합니다. 사용자는 사용자 인터페이스를 통해 로그아웃할 수도 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | p2p.h |
| 라이브러리 | P2P.lib |
| DLL | P2P.dll |