Função PeerGroupImportConfig (p2p.h)

A função PeerGroupImportConfig importa uma configuração de grupo par para uma identidade com base nas configurações específicas em uma cadeia de caracteres de configuração XML fornecida.

Sintaxe

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 uma cadeia de caracteres Unicode que contém uma configuração de grupo par exportada anteriormente (usando PeerGroupExportConfig). Para obter o formato XML específico da cadeia de caracteres, consulte a seção Comentários deste tópico. Este parâmetro é necessário.

[in] pwzPassword

Especifica a senha usada para acessar os dados de configuração do grupo de pares criptografados, como uma cadeia de caracteres Unicode. Este parâmetro é necessário.

[in] fOverwrite

Se for true, a configuração de grupo existente será substituída. Se for false, a configuração do grupo será gravada somente se uma configuração de grupo anterior não existir. O valor padrão é false. Este parâmetro é necessário.

[out] ppwzIdentity

Contém a identidade de par retornada após a conclusão de uma importação. Este parâmetro é necessário.

[out] ppwzGroup

Contém um nome de par de grupo de pares retornado após a conclusão de uma importação. Este parâmetro é necessário.

Retornar valor

Retorna S_OK se a função for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.

Código de retorno	Descrição
E_INVALIDARG	Um dos parâmetros não é válido.
E_OUTOFMEMORY	Não há memória suficiente para executar uma operação especificada.
PEER_E_ALREADY_EXISTS	Já existe uma configuração de grupo par e fOverwrite é definido como false.

 

Erros específicos de criptografia podem ser retornados do Provedor Base do Microsoft RSA. Esses erros são prefixados com CRYPT_* e definidos em Winerror.h.

Comentários

Para gerar uma configuração de grupo par, chame PeerGroupExportConfig, passe uma identidade para exportar, uma senha e um identificador para o grupo de pares.

A cadeia de caracteres XML de configuração aparece no seguinte formato:

<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	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	p2p.h
Biblioteca	P2P.lib
DLL	P2P.dll