Função PeerDistClientAddData (peerdist.h)

A função PeerDistClientAddData é usada para fornecer conteúdo ao cache local. Normalmente, isso é feito quando os dados não podem ser encontrados na rede local, conforme indicado quando PeerDistClientBlockRead ou PeerDistClientStreamRead são concluídos com ERROR_TIMEOUT ou PEERDIST_ERROR_MISSING_DATA.

Sintaxe

DWORD PeerDistClientAddData(
  [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 retornado por PeerDistClientOpenContent.

cbNumberOfBytes

O número de bytes a serem adicionados ao cache local.

[in] pBuffer

Ponteiro para o buffer que contém os dados a serem adicionados ao cache local. 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 deslocamento de bytes do início do conteúdo, no qual esses dados estão sendo adicionados, é especificado definindo os membros Offset e OffsetHigh da estrutura OVERLAPPED . O membro OffsetHigh DEVE ser definido como os 32 bits mais altos do deslocamento de bytes e o membro Offset DEVE ser definido como os 32 bits inferiores do deslocamento de bytes.

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 ou hContent é 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

Os dados que foram adicionados com essa função e passaram pela verificação estão disponíveis para outros pares ou cache hospedado para download. O serviço distribuição de pares armazena esses dados em seu cache local.

Se a API for concluída com PEERDIST_ERROR_OUT_OF_BOUNDS, isso indicará que o deslocamento especificado na estrutura sobreposta está além do final do conteúdo.

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

PeerDistClientBlockRead

PeerDistClientStreamRead

PeerDistStartup