PeerGroupImportConfig 함수(p2p.h)

PeerGroupImportConfig 함수는 제공된 XML 구성 문자열의 특정 설정을 기반으로 ID에 대한 피어 그룹 구성을 가져옵니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupImportConfig(
  [in]  PCWSTR pwzXML,
  [in]  PCWSTR pwzPassword,
  [in]  BOOL   fOverwrite,
  [out] PWSTR  *ppwzIdentity,
  [out] PWSTR  *ppwzGroup
);

매개 변수

[in] pwzXML

이전에 내보낸( PeerGroupExportConfig 사용) 피어 그룹 구성을 포함하는 유니코드 문자열을 지정합니다. 문자열의 특정 XML 형식은 이 항목의 설명 섹션을 참조하세요. 이 매개 변수는 필수입니다.

[in] pwzPassword

암호화된 피어 그룹 구성 데이터에 액세스하는 데 사용되는 암호를 유니코드 문자열로 지정합니다. 이 매개 변수는 필수입니다.

[in] fOverwrite

true이면 기존 그룹 구성을 덮어씁니다. false이면 이전 그룹 구성이 없는 경우에만 그룹 구성이 작성됩니다. 기본값은 false입니다. 이 매개 변수는 필수입니다.

[out] ppwzIdentity

가져오기가 완료된 후 반환되는 피어 ID를 포함합니다. 이 매개 변수는 필수입니다.

[out] ppwzGroup

가져오기가 완료된 후 반환되는 피어 그룹 피어 이름을 포함합니다. 이 매개 변수는 필수입니다.

반환 값

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

암호화 관련 오류는 Microsoft RSA 기본 공급자에서 반환할 수 있습니다. 이러한 오류에는 CRYPT_* 접두사로 지정되고 Winerror.h에 정의되어 있습니다.

설명

피어 그룹 구성을 생성하려면 PeerGroupExportConfig를 호출하고 내보낼 ID, 암호 및 핸들을 피어 그룹에 전달합니다.

구성 XML 문자열은 다음 형식으로 표시됩니다.

<PEERGROUPCONFIG VERSION="1.0">
  <IDENTITYPEERNAME>
    <!-- UTF-8 encoded peer name of the identity -->
  </IDENTITYPEERNAME>
  <GROUPPEERNAME>
    <!-- UTF-8 encoded peer name of the peer group -->
  </GROUPPEERNAME>
  <CLOUDNAME>
    <!-- UTF-8 encoded Unicode name of the cloud -->
  </CLOUDNAME>
  <SCOPE>
    <!-- UTF-8 encoded Unicode name of the scope: global, site-local, link-local -->
  </SCOPE>
  <CLOUDFLAGS>
    <!-- A DWORD that contains cloud-specific settings, represented as a string -->
  </CLOUDFLAGS>
  <GMC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
    <!-- base64/PKCS7 encoded GMC chain -->
  </GMC>
</PEERGROUPCONFIG>

요구 사항