Função PeerDistStartup (peerdist.h)

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:

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

Confira também

PeerDistShutdown