다음을 통해 공유

PeerIdentityGetXML 함수(p2p.h)

  • 아티클

PeerIdentityGetXML 함수는 피어 ID에 대한 설명을 반환합니다. 그러면 타사에 전달되고 피어 ID를 피어 그룹에 초대하는 데 사용할 수 있습니다. 이 정보는 XML 조각으로 반환됩니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetXML(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzIdentityXML
);

매개 변수

[in] pwzIdentity

피어 ID 정보를 검색할 피어 ID를 지정합니다. 이 매개 변수가 NULL로 전달되면 피어 인프라에서 사용자에 대해 "기본" ID가 생성됩니다.

[out] ppwzIdentityXML

XML 조각이 포함된 유니코드 문자열에 대한 포인터에 대한 포인터입니다. ppwzIdentityXML이 더 이상 필요하지 않은 경우 애플리케이션은 PeerFreeData를 호출하여 이 문자열을 해제해야 합니다.

반환 값

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

반환 코드 설명
E_HANDLE
 ID에 대한 핸들이 잘못되었습니다.
E_INVALIDARG
 매개 변수 중 하나가 잘못되었습니다.
E_OUTOFMEMORY
 지정된 작업을 수행하기에 충분한 메모리가 없습니다.

설명

반환된 XML 조각에는 다음과 같은 구조가 있습니다.

<PEERIDENTITYINFO VERSION="1.0">
     <IDC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
          Base 64 encoded certificate.
     </IDC>
</PEERIDENTITYINFO>

이 XML 조각은 그룹에 가입하도록 초대를 만들 때 사용됩니다.

애플리케이션은 PEERIDENTITYINFO 태그 내에 태그를 추가하거나 어떤 식으로든 이 XML 조각을 수정할 수 없습니다. 애플리케이션은 이 XML 조각을 다른 XML 문서에 통합할 수 있지만 이 조각을 PeerGroupCreateInvitation에 전달하기 전에 모든 애플리케이션별 XML을 제거해야 합니다.

요구 사항

   
지원되는 최소 클라이언트 WINDOWS XP SP2 [데스크톱 앱만 해당], Windows XP용 고급 네트워킹 팩이 있는 WINDOWS XP SP1
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 p2p.h
라이브러리 P2P.lib
DLL P2P.dll

추가 정보

PEER_CONTACT

PeerFreeData

PeerGroupCreateInvitation