PeerCollabEnumApplicationRegistrationInfo 함수(p2p.h)
PeerCollabEnumApplicationRegistrationInfo 함수는 피어 애플리케이션 정보를 검색하는 데 사용되는 열거형 핸들을 가져옵니다.
구문
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplicationRegistrationInfo(
[in] PEER_APPLICATION_REGISTRATION_TYPE registrationType,
[out] HPEERENUM *phPeerEnum
);
매개 변수
[in] registrationType
피어의 애플리케이션이 현재 사용자 또는 피어 머신의 모든 사용자에 등록되었는지 여부를 지정하는 PEER_APPLICATION_REGISTRATION_TYPE 값입니다.
[out] phPeerEnum
피어 애플리케이션 등록 정보에 대한 피어 열거형 핸들에 대한 포인터입니다. 이 데이터는 이 핸들을 PeerGetNextItem에 전달하여 가져옵니다.
반환 값
함수가 성공하면 S_OK 반환합니다. 그렇지 않으면 함수는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
이 작업을 지원하기에 충분한 메모리가 없습니다. |
|
인수 중 하나가 잘못되었습니다. |
|
Windows 피어 인프라가 초기화되지 않았습니다. 관련 초기화 함수를 호출해야 합니다. |
설명
개별 피어 애플리케이션을 가져오려면 반환된 핸들을 PeerGetNextItem에 전달합니다. PEER_APPLICATION_REGISTRATION_INFO 구조체의 배열이 반환됩니다. 열거형을 닫고 연결된 리소스를 해제하려면 이 핸들을 PeerEndEnumeration에 전달합니다. 열거형에서 반환된 개별 항목은 PeerFreeData를 사용하여 해제해야 합니다.
애플리케이션은 피어의 엔드포인트에서 사용할 수 있는 소프트웨어 또는 소프트웨어 기능 집합입니다. 일반적으로 이는 게임 또는 기타 공동 작업 애플리케이션과 같은 피어 네트워킹 활동을 지원하는 소프트웨어 패키지를 나타냅니다.
피어의 애플리케이션에는 단일 특정 애플리케이션을 나타내는 GUID가 있습니다. 애플리케이션이 피어에 등록되면 피어의 신뢰할 수 있는 모든 연락처에서 이 GUID 및 해당 애플리케이션을 사용할 수 있으며 이는 피어가 참여할 수 있는 활동을 나타냅니다. 피어의 애플리케이션을 등록 취소하려면 이 GUID를 사용하여 PeerCollabUnregisterApplication 을 호출합니다.
피어 애플리케이션 등록 정보 항목은 개별 PEER_APPLICATION_REGISTRATION_INFO 구조로 반환됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | p2p.h |
| 라이브러리 | P2P.lib |
| DLL | P2P.dll |
추가 정보
PEER_APPLICATION_REGISTRATION_INFO