Função PeerDistClientOpenContent (peerdist.h)

Artigo
08/25/2023

A função PeerDistClientOpenContent é aberta e retorna um PEERDIST_CONTENT_HANDLE. O cliente usa o identificador de conteúdo para recuperar dados do serviço distribuição de pares.

Sintaxe

DWORD PeerDistClientOpenContent(
  [in]           PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in]           PCPEERDIST_CONTENT_TAG   pContentTag,
  [in, optional] HANDLE                   hCompletionPort,
  [in, optional] ULONG_PTR                ulCompletionKey,
  [out]          PPEERDIST_CONTENT_HANDLE phContentHandle
);

Parâmetros

[in] hPeerDist

Um PEERDIST_INSTANCE_HANDLE retornado por PeerDistStartup.

[in] pContentTag

Ponteiro para uma estrutura de PEERDIST_CONTENT_TAG que contém um identificador especificado pelo cliente de 16 bytes. Esse parâmetro é usado em conjunto com a função PeerDistClientFlushContent .

[in, optional] hCompletionPort

Um identificador para a porta de conclusão que pode ser usado para recuperar a notificação de conclusão da função assíncrona. Para criar uma porta de conclusão, use a função CreateIoCompletionPort Esse parâmetro pode ser NULL.

[in, optional] ulCompletionKey

Valor a ser retornado por meio do parâmetro lpCompletionKey da função GetQueuedCompletionStatus . Esse parâmetro é ignorado quando hCompletionPort é NULL.

[out] phContentHandle

Um ponteiro para uma variável que recebe o PEERDIST_CONTENT_HANDLE usado para recuperar ou adicionar dados.

Valor retornado

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:

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

O cliente deve chamar a função PeerDistClientOpenContent para obter um identificador PEERDIST_CONTENT_HANDLE que posteriormente pode ser usado nas seguintes funções:

Se um identificador de porta de conclusão opcional for especificado, ele será usado para postar os resultados de conclusão de funções assíncronas listadas acima.

O identificador retornado pela chamada de função PeerDistClientOpenContent deve ser fechado pela função PeerDistClientCloseContent .

Requisitos


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