Compartilhar via

Função PeerGroupCreate (p2p.h)

  • Artigo

A função PeerGroupCreate cria um novo grupo de pares.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreate(
  [in]  PPEER_GROUP_PROPERTIES pProperties,
  [out] HGROUP                 *phGroup
);

Parâmetros

[in] pProperties

Ponteiro para uma estrutura PEER_GROUP_PROPERTIES que especifica os detalhes específicos do grupo, como nomes de grupo de pares, tempos de vida de convite e tempos de vida de presença. Este parâmetro é necessário.

Os seguintes membros devem ser definidos:

  • pwzCreatorPeerName

Os seguintes membros não podem ser definidos:

  • pwzGroupPeerName
Os membros restantes são opcionais.

[out] phGroup

Retorna o ponteiro do identificador para o grupo de pares. Qualquer função chamada com esse identificador como parâmetro tem a ação correspondente executada nesse grupo de pares. Este parâmetro é necessário.

Retornar valor

Retorna S_OK se a operaçã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_CLOUD_NAME_AMBIGUOUS
 A nuvem especificada em pProperties não pode ser descoberta exclusivamente (mais de uma nuvem corresponde ao nome fornecido).
PEER_E_INVALID_CLASSIFIER
 O classificador de grupo par especificado em pProperties é inválido.
PEER_E_INVALID_PEER_NAME
 O nome do par especificado para o grupo em pProperties é inválido.
PEER_E_INVALID_PROPERTIES
 Uma ou mais das propriedades do grupo de pares fornecidas em pProperties são inválidas.
PEER_E_NO_CLOUD
 A nuvem especificada em pProperties não pode ser localizada.
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.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY
 A senha especificada não atende aos requisitos de senha do sistema.
ERROR_DELETE_PENDING
 A identidade de par especificada como o Criador de Grupo foi excluída ou está em processo de exclusão.
 

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

PeerGroupConnect deve ser chamado pelo criador do grupo imediatamente após a criação. Se isso não ocorrer, os usuários que receberem um convite chamarão PeerGroupConnect com êxito, mas não poderão escutar e, eventualmente, receberão o evento com falha de conexão.

Um aplicativo obtém uma identidade chamando PeerIdentityCreate ou qualquer outro método que retorna uma cadeia de caracteres de nome de identidade. Essa identidade serve como o proprietário do grupo e é o membro inicial do grupo de pares quando criado.

Para aplicativos que utilizam senhas, é recomendável que as senhas sejam tratadas com segurança chamando as funções CryptoProtectMemory e SecureZeroMemory .

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

Confira também

PEER_GROUP_PROPERTIES

PeerGroupClose

PeerGroupConnect

PeerGroupOpen