PeerGroupImportConfig-Funktion (p2p.h)

Die PeerGroupImportConfig-Funktion importiert eine Peergruppenkonfiguration für eine Identität basierend auf den spezifischen Einstellungen in einer angegebenen XML-Konfigurationszeichenfolge.

Syntax

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

Parameter

[in] pwzXML

Gibt eine Unicode-Zeichenfolge an, die eine zuvor exportierte Peergruppenkonfiguration (mit PeerGroupExportConfig) enthält. Das spezifische XML-Format der Zeichenfolge finden Sie im Abschnitt Hinweise dieses Themas. Dieser Parameter ist erforderlich.

[in] pwzPassword

Gibt das Kennwort für den Zugriff auf die verschlüsselten Peergruppenkonfigurationsdaten als Unicode-Zeichenfolge an. Dieser Parameter ist erforderlich.

[in] fOverwrite

Wenn true, wird die vorhandene Gruppenkonfiguration überschrieben. Bei false wird die Gruppenkonfiguration nur geschrieben, wenn keine vorherige Gruppenkonfiguration vorhanden ist. Der Standardwert ist „FALSE“. Dieser Parameter ist erforderlich.

[out] ppwzIdentity

Enthält die Peeridentität, die nach Abschluss eines Imports zurückgegeben wird. Dieser Parameter ist erforderlich.

[out] ppwzGroup

Enthält einen Peergruppen-Peernamen, der nach Abschluss eines Imports zurückgegeben wird. 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 RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

Hinweise

Um eine Peergruppenkonfiguration zu generieren, rufen Sie PeerGroupExportConfig auf, übergeben Sie eine zu exportierende Identität, ein Kennwort und ein Handle an die Peergruppe.

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 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>

Anforderungen