Función PeerGroupImportConfig (p2p.h)

La función PeerGroupImportConfig importa una configuración de grupo del mismo nivel para una identidad en función de la configuración específica de una cadena de configuración XML proporcionada.

Sintaxis

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

Parámetros

[in] pwzXML

Especifica una cadena Unicode que contiene una configuración de grupo del mismo nivel exportada anteriormente (mediante PeerGroupExportConfig). Para obtener el formato XML específico de la cadena, vea la sección Comentarios de este tema. Este parámetro es obligatorio.

[in] pwzPassword

Especifica la contraseña usada para tener acceso a los datos de configuración cifrados del grupo del mismo nivel, como una cadena Unicode. Este parámetro es obligatorio.

[in] fOverwrite

Si es true, se sobrescribe la configuración del grupo existente. Si es false, la configuración del grupo solo se escribe si no existe una configuración de grupo anterior. El valor predeterminado es false. Este parámetro es obligatorio.

[out] ppwzIdentity

Contiene la identidad del mismo nivel devuelta después de que se complete una importación. Este parámetro es obligatorio.

[out] ppwzGroup

Contiene un nombre del mismo nivel de grupo del mismo nivel devuelto después de que se complete una importación. Este parámetro es obligatorio.

Valor devuelto

Devuelve S_OK si la función se realiza correctamente. De lo contrario, la función devuelve uno de los valores siguientes.

Código devuelto	Descripción
E_INVALIDARG	Uno de los parámetros no es válido.
E_OUTOFMEMORY	No hay suficiente memoria para realizar una operación especificada.
PEER_E_ALREADY_EXISTS	Ya existe una configuración de grupo del mismo nivel y fOverwrite se establece en false.

 

Los errores específicos de criptografía se pueden devolver desde el proveedor base RSA de Microsoft. Estos errores tienen el prefijo CRYPT_* y se definen en Winerror.h.

Comentarios

Para generar una configuración de grupo del mismo nivel, llame a PeerGroupExportConfig, pase una identidad para exportar, una contraseña y un identificador al grupo del mismo nivel.

La cadena XML de configuración aparece en el formato siguiente:

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2P.lib
Archivo DLL	P2P.dll