PeerCollabExportContact 함수(p2p.h)

PeerCollabExportContact 함수는 피어 이름과 연결된 연락처 데이터를 문자열 버퍼로 내보냅니다. 버퍼에는 XML 형식의 연락처 데이터가 포함됩니다.

PeerCollabAddContact 함수를 사용하면 다른 피어에서 이 XML 문자열을 사용할 수 있습니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabExportContact(
  [in, optional]  PCWSTR pwzPeerName,
  [out, optional] PWSTR  *ppwzContactData
);

[in, optional] pwzPeerName

내보낼 피어 연락처의 이름을 포함하는 0으로 끝나는 유니코드 문자열에 대한 포인터입니다.

이 매개 변수가 NULL이면 호출 피어에 대한 "Me" 연락처 정보가 내보내집니다.

[out, optional] ppwzContactData

피어 이름이 pwzPeerName에 제공된 문자열과 일치하는 피어 연락처 XML 데이터를 포함하는 0으로 끝나는 문자열 버퍼에 대한 포인터입니다.

여기서 반환된 메모리는 PeerFreeData를 호출하여 해제할 수 있습니다.

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

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