PeerCollabRegisterApplication 함수(p2p.h)

PeerCollabRegisterApplication 함수는 피어 협업 작업에서 시작할 수 있도록 로컬 컴퓨터에 애플리케이션을 등록합니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterApplication(
  [in] PCPEER_APPLICATION_REGISTRATION_INFO pcApplication,
  [in] PEER_APPLICATION_REGISTRATION_TYPE   registrationType
);

매개 변수

[in] pcApplication

피어 애플리케이션 기능 집합의 UUID와 추가 피어별 데이터를 포함하는 PEER_APPLICATION_REGISTRATION_INFO 구조체에 대한 포인터입니다.

[in] registrationType

피어의 애플리케이션이 현재 사용자 또는 피어 컴퓨터의 모든 사용자에게 등록되었는지 여부를 설명하는 PEER_APPLICATION_REGISTRATION_TYPE 값입니다.

반환 값

함수가 성공하면 S_OK 반환합니다. 그렇지 않으면 함수는 다음 값 중 하나를 반환합니다.

설명

애플리케이션은 피어의 엔드포인트에서 사용할 수 있는 소프트웨어 또는 소프트웨어 기능 집합입니다. 일반적으로 이는 게임 또는 기타 공동 작업 애플리케이션과 같은 피어 네트워킹 활동을 지원하는 소프트웨어 패키지를 나타냅니다.

협업 인프라는 PeerCollabSignin을 사용하여 협업 인프라가 로그인되는 scope 기반으로 하는 신뢰할 수 있는 연락처 또는 "사람 Near Me"에서 애플리케이션 초대를 받을 수 있습니다.

피어의 애플리케이션에는 단일 특정 애플리케이션을 나타내는 GUID가 있습니다. 애플리케이션이 피어에 등록되면 피어의 신뢰할 수 있는 모든 연락처에서 이 GUID 및 해당 애플리케이션을 사용할 수 있으며 이는 피어가 참여할 수 있는 활동을 나타냅니다. 피어의 애플리케이션을 등록 취소하려면 이 GUID를 사용하여 PeerCollabUnregisterApplication 을 호출합니다.

애플리케이션을 등록할 때 개발자는 절대 경로 대신 상대 경로(예: %ProgramFiles%)를 지정하는 것이 좋습니다. 이렇게 하면 애플리케이션 파일의 위치가 변경되어 애플리케이션 오류가 발생하지 않습니다. 예를 들어 C:\ProgramFiles 디렉터리가 E:\로 이동된 경우입니다.

컴퓨터에 로컬인 애플리케이션만 등록할 수 있습니다. 애플리케이션의 실행 경로가 UNC 경로 또는 로컬로 매핑된 네트워크 드라이브와 같은 네트워크 공유에 있는 경우 등록할 수 없습니다.

애플리케이션은 'ALL_USERS' 및 'CURRENT_USER' 범위에 등록할 수 있습니다. 애플리케이션이 두 범위에 동시에 등록된 경우 'CURRENT_USER' scope 등록된 애플리케이션이 'ALL_USERS' scope 등록된 애플리케이션보다 우선합니다. 'ALL_USERS' 등록 유형에 등록하려면 호출자가 관리 권한으로 작동해야 합니다.

특정 registrationType 에 등록할 수 있는 최대 애플리케이션 수는 64개입니다.

요구 사항

추가 정보

PEER_APPLICATION_REGISTRATION_TYPE

피어 협업 API 함수

PeerCollabUnregisterApplication