Função PeerDistClientAddContentInformation (peerdist.h)
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 |
|---|---|
|
Um ou mais parâmetros são inválidos. |
|
O identificador hPeerDist é inválido. |
|
O recurso é desabilitado por Política de Grupo. |
|
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 |