PeerGroupExportConfig-Funktion (p2p.h)

Die PeerGroupExportConfig-Funktion exportiert die Gruppenkonfiguration für einen Peer als XML-Zeichenfolge, die die Identität, den Gruppennamen und den GMC für die Identität enthält.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupExportConfig(
  [in]  HGROUP hGroup,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzXML
);

Parameter

[in] hGroup

Handle für die Gruppe. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] pwzPassword

Gibt das Kennwort an, das zum Schützen der exportierten Konfiguration verwendet wird. Es gibt keine Regeln oder Grenzwerte für die Bildung dieses Kennworts. Dieser Parameter ist erforderlich.

[out] ppwzXML

Zeiger auf die zurückgegebene XML-Konfigurationszeichenfolge, die die Identität, den Gruppenpeernamen, den Cloudpeernamen, den Gruppenbereich und den GMC für die Identität enthält. Dieser Parameter ist erforderlich.

Rückgabewert

Gibt S_OK zurück, wenn die Funktion erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Kryptografiespezifische Fehler können vom Microsoft-Basis-Kryptografieanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

Hinweise

Nach dem Export kann diese Konfiguration out-of-band an einen anderen Peer übergeben werden, wo die Konfiguration der Identität eingerichtet werden kann. Um die Konfiguration zu importieren, übergeben Sie die von dieser Funktion zurückgegebene XML-Zeichenfolge mit dem darauf festgelegten Kennwort an PeerGroupImportConfig.

Die XML-Konfigurationszeichenfolge wird im folgenden Format angezeigt:

<PEERGROUPCONFIG VERSION="1.0">
  <IDENTITYPEERNAME>
    <!-- UTF-8 encoded peer name of the identity -->
  </IDENTITYPEERNAME>
  <GROUPPEERNAME>
    <!-- UTF-8 encoded peer name of the 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 containing 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>

Anforderungen