Função PeerDistServerRetrieveContentInformation (peerdist.h)

  • Artigo

A função PeerDistServerRetrieveContentInformation recupera as informações de conteúdo codificadas associadas a um identificador retornado por PeerDistServerOpenContentInformation.

Sintaxe

DWORD PeerDistServerRetrieveContentInformation(
  [in]      PEERDIST_INSTANCE_HANDLE    hPeerDist,
  [in]      PEERDIST_CONTENTINFO_HANDLE hContentInfo,
            DWORD                       cbMaxNumberOfBytes,
  [in, out] PBYTE                       pBuffer,
  [in]      LPOVERLAPPED                lpOverlapped
);

Parâmetros

[in] hPeerDist

Um PEERDIST_INSTANCE_HANDLE retornado por PeerDistStartup.

[in] hContentInfo

O identificador retornado por PeerDistServerOpenContentInformation.

cbMaxNumberOfBytes

O número máximo de bytes a serem lidos.

[in, out] pBuffer

Ponteiro para o buffer que recebe os dados de informações de conteúdo.

[in] lpOverlapped

Ponteiro para uma estrutura OVERLAPPED . Essa função não permite que o chamador especifique o Deslocamento inicial no conteúdo. O deslocamento é mantido implicitamente por hContentInfo. O Offset e o OffsetHigh são reservados e devem ser zero.

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 hContentInfo é inválido.
PEERDIST_ERROR_NO_MORE
 O EOF sobre as informações de conteúdo foi alcançado.
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

No sucesso da operação PeerDistServerRetrieveContentInformation , os campos Offset e OffsetHigh da estrutura OVERLAPPED serão preenchidos com o deslocamento ULONGLONG nas informações de conteúdo que foram recuperadas. O membro OffsetHigh será definido como os 32 bits mais altos do deslocamento e o membro Offset será definido como os 32 bits inferiores do deslocamento.

GetOverlappedResult preencherá lpNumberOfBytesTransferred com o número de bytes transferidos. Caso o chamador esteja usando uma porta de conclusão para processar conclusões da API de Distribuição de Pares, o argumento lpNumberOfBytes de GetQueuedCompletionStatus será preenchido com o número de bytes transferidos.

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

PeerDistServerOpenContentInformation

PeerDistStartup