Compartilhar via

Função PeerGroupExportConfig (p2p.h)

  • Artigo

A função PeerGroupExportConfig exporta a configuração de grupo para um par como uma cadeia de caracteres XML que contém a identidade, o nome do grupo e o GMC para a identidade.

Sintaxe

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

Parâmetros

[in] hGroup

Manipule para o grupo. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.

[in] pwzPassword

Especifica a senha usada para proteger a configuração exportada. Não há regras ou limites para a formação dessa senha. Este parâmetro é necessário.

[out] ppwzXML

Ponteiro para a cadeia de caracteres de configuração XML retornada que contém a identidade, o nome do par do grupo, o nome do par de nuvem, o escopo do grupo e o GMC para a identidade. 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 a operação especificada.
PEER_E_NO_KEY_ACCESS
 O acesso às chaves de identidade ou grupo é negado. Normalmente, isso é causado por uma ACL (lista de controle de acesso) incorreta para a pasta que contém as chaves do usuário ou do computador. Isso pode acontecer quando a ACL é redefinida manualmente.
 

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

Comentários

Depois de exportada, essa configuração pode ser passada fora de banda para outro par, onde a configuração da identidade pode ser estabelecida. Para importar a configuração, passe a cadeia de caracteres XML retornada por essa função com a senha definida nela para PeerGroupImportConfig.

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