PeerCollabSetObject 함수(p2p.h)

PeerCollabSetObject 함수는 피어 협업 네트워크에서 사용되는 피어 데이터 개체를 만들거나 업데이트합니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
  [in] PCPEER_OBJECT pcObject
);

[in] pcObject

피어 협업 네트워크의 피어 개체를 포함하는 PEER_OBJECT 구조체에 대한 포인터입니다.

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

반환 코드	설명
E_OUTOFMEMORY	이 작업을 지원하기에 충분한 메모리가 없습니다.
E_INVALIDARG	인수 중 하나가 잘못되었습니다.
PEER_E_NOT_INITIALIZED	Windows 피어 인프라가 초기화되지 않았습니다. 관련 초기화 함수를 호출해야 합니다.
PEER_E_NOT_SIGNED_IN	작업을 수행하려면 사용자가 로그인해야 합니다.

피어 개체는 그림, 아바타, 인증서 또는 특정 설명과 같은 특정 애플리케이션과 연결된 런타임 데이터 항목입니다. 각 피어 개체의 크기는 16K보다 작아야 하며 0일 수 없습니다.

개체가 이미 게시된 경우 PeerCollabSetObject 는 기존 개체 데이터를 업데이트합니다. 개체를 업데이트하는 마지막 애플리케이션은 개체의 소유권을 맡게 됩니다. 결과적으로 애플리케이션이 종료되면 개체가 삭제됩니다.

연결된 애플리케이션의 닫기가 아니라 로그아웃으로 인해 개체의 '게시된' 상태 제거되면 애플리케이션은 다음에 사용자가 로그온할 때 개체를 게시해야 합니다.

이 피어 개체를 보는 신뢰할 수 있는 연락처는 PEER_EVENT_OBJECT_CHANGED 이벤트가 로컬로 발생하여 이 피어 개체가 상태 변경되었음을 알릴 수 있습니다.

PeerCollabSetObject 를 사용하여 최대 128개 개체를 게시할 수 있습니다.

지정된 시간에 게시된 지정된 GUID 가 있는 개체가 하나 있습니다.