Función PeerGroupExportConfig (p2p.h)

La función PeerGroupExportConfig exporta la configuración de grupo para un elemento del mismo nivel como una cadena XML que contiene la identidad, el nombre del grupo y el GMC para la identidad.

Sintaxis

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

Parámetros

[in] hGroup

Identificador del grupo. La función PeerGroupCreate, PeerGroupOpen o PeerGroupJoin devuelve este identificador. Este parámetro es obligatorio.

[in] pwzPassword

Especifica la contraseña usada para proteger la configuración exportada. No hay reglas ni límites para la formación de esta contraseña. Este parámetro es obligatorio.

[out] ppwzXML

Puntero a la cadena de configuración XML devuelta que contiene la identidad, el nombre del mismo nivel del grupo, el nombre del mismo nivel en la nube, el ámbito del grupo y el GMC para la identidad. 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 la operación especificada.
PEER_E_NO_KEY_ACCESS	Se deniega el acceso a las claves de identidad o grupo. Normalmente, esto se debe a una lista de control de acceso (ACL) incorrecta para la carpeta que contiene las claves de usuario o equipo. Esto puede ocurrir cuando la ACL se restablece manualmente.

 

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

Comentarios

Después de exportarse, esta configuración se puede pasar fuera de banda a otro elemento del mismo nivel, donde se puede establecer la configuración de la identidad. Para importar la configuración, pase la cadena XML devuelta por esta función con la contraseña establecida en peerGroupImportConfig.

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

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