Função PeerDistStartup (peerdist.h)

  • Artigo

A função PeerDistStartup cria um novo identificador de instância de Distribuição de Pares que deve ser passado para todas as outras APIs de Distribuição de Pares.

Sintaxe

DWORD PeerDistStartup(
  [in]            DWORD                     dwVersionRequested,
  [out]           PPEERDIST_INSTANCE_HANDLE phPeerDist,
  [out, optional] PDWORD                    pdwSupportedVersion
);

Parâmetros

[in] dwVersionRequested

Contém a versão mínima da Distribuição de Pares solicitada pelo aplicativo. O byte de ordem alta especifica o número de versão secundária; o byte de ordem baixa especifica o número de versão principal.

[out] phPeerDist

Um ponteiro para uma variável PEERDIST_INSTANCE_HANDLE que, após o sucesso, recebe um identificador recém-criado.

[out, optional] pdwSupportedVersion

Um ponteiro para uma variável que, se não for NULL, contém o número máximo de versão compatível com o sistema de Distribuição por Pares. O byte de ordem alta especifica o número de versão secundária; o byte de ordem baixa especifica o número de versão principal.

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS. Caso contrário, a função pode retornar um dos seguintes valores:

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Um ou mais parâmetros são inválidos.
PEERDIST_ERROR_VERSION_UNSUPPORTED
 Não há suporte para a versão solicitada pela DLL do lado do cliente.

Comentários

PeerDistStartup deve ser chamado antes de qualquer outra função de Distribuição de Pares. Quando não for mais necessário, o identificador retornado por PeerDistStartup deverá ser fechado por meio de uma chamada para PeerDistShutdown.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho peerdist.h
Biblioteca PeerDist.lib
DLL PeerDist.dll

Confira também

PeerDistShutdown