Função PeerDistClientAddContentInformation (peerdist.h)

  • Artigo

A função PeerDistClientAddContentInformation adiciona as informações de conteúdo associadas a um identificador de conteúdo aberto por PeerDistClientOpenContent.

Sintaxe

DWORD PeerDistClientAddContentInformation(
  [in] PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in] PEERDIST_CONTENT_HANDLE  hContentHandle,
       DWORD                    cbNumberOfBytes,
  [in] PBYTE                    pBuffer,
  [in] LPOVERLAPPED             lpOverlapped
);

Parâmetros

[in] hPeerDist

Um PEERDIST_INSTANCE_HANDLE retornado por PeerDistStartup.

[in] hContentHandle

Um PEERDIST_CONTENT_HANDLE aberto por PeerDistClientOpenContent.

cbNumberOfBytes

Número de bytes na matriz pBuffer .

[in] pBuffer

Ponteiro para o buffer que contém as informações de conteúdo. Esse buffer deve permanecer válido durante a operação de adição. O chamador não deve usar esse buffer até que a operação de adição seja concluída.

[in] lpOverlapped

Ponteiro para uma estrutura OVERLAPPED . O membro interno da estrutura OVERLAPPED contém a status de conclusão da operação assíncrona. O Deslocamento e OffsetHigh são reservados e devem ser 0.

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_IO_PENDING. 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.
ERROR_INVALID_HANDLE
 O identificador hPeerDist é inválido.
ERROR_ACCESS_DISABLED_BY_POLICY
 O recurso é desabilitado por Política de Grupo.
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 O serviço está indisponível.

Comentários

Para recuperar dados de conteúdo do serviço distribuição de pares, o cliente deve adicionar informações de conteúdo que recebeu do servidor de conteúdo chamando a função PeerDistClientAddContentInformation . Quando todos os dados de informações de conteúdo tiverem sido adicionados, a função PeerDistClientCompleteContentInformation deverá ser chamada. Depois que PeerDistClientCompleteContentInformation for concluído, o cliente poderá chamar PeerDistClientStreamRead ou PeerDistClientBlockRead para recuperar os dados do sistema de Distribuição par.

Ao chamar essa função várias vezes em um único identificador de conteúdo, o chamador deve aguardar a conclusão de cada operação antes que a próxima chamada seja feita.

Um aplicativo não se limita à adição de informações de conteúdo com uma única chamada à API PeerDistClientAddContentInformation , pois é possível adicionar partes dessas informações de conteúdo à medida que são disponibilizadas. Quando mais informações de conteúdo estiverem disponíveis, o aplicativo poderá chamar PeerDistClientAddContentInformation novamente. Quando o aplicativo terminar de adicionar todas as informações de conteúdo, ele deverá chamar PeerDistClientCompleteContentInformation.

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

PeerDistClientCompleteContentInformation

PeerDistClientOpenContent

PeerDistStartup