Compartilhar via

Função PeerGroupStartup (p2p.h)

  • Artigo

A função PeerGroupStartup inicia um grupo de pares usando uma versão solicitada da infraestrutura peer.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupStartup(
  [in]  WORD               wVersionRequested,
  [out] PPEER_VERSION_DATA pVersionData
);

Parâmetros

[in] wVersionRequested

Especifica a versão mais alta da Infraestrutura de Pares que um chamador pode dar suporte. O byte de ordem alta especifica o número da versão secundária (revisão). O byte de ordem baixa especifica o número de versão principal Esse parâmetro é necessário.

[out] pVersionData

Ponteiro para uma estrutura de PEER_VERSION_DATA que contém o nível específico de suporte fornecido pela Infraestrutura de Pares. 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
ERROR_SERVICE_DEPENDENCY_FAIL
 O serviço PNRP (Peer Name Resolution Protocol) deve ser iniciado antes de chamar PeerGroupStartup.
E_OUTOFMEMORY
 Não há memória suficiente disponível para concluir a operação.
PEER_E_IPV6_NOT_INSTALLED
 O serviço de agrupamento não foi iniciado porque o IPv6 não está instalado no computador.
PEER_E_UNSUPPORTED_VERSION
 Não há suporte para a versão solicitada pelo subsistema Peer instalado.
 

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

O serviço PNRP (Peer Name Resolution Protocol) deve ser iniciado antes de chamar essa função.

Essa função é chamada pelo aplicativo antes de chamar qualquer outra função de Agrupamento de Pares.

Para esta versão, os aplicativos devem usar PEER_GROUP_VERSION como a versão solicitada.

Um grupo de pares iniciado com essa função é fechado chamando PeerGroupShutdown quando o aplicativo é encerrado.

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

Agrupando funções de API

PEER_VERSION_DATA

PeerGroupShutdown