Função PeerDistServerOpenContentInformation (peerdist.h)

  • Artigo

A função PeerDistServerOpenContentInformation abre uma PEERDIST_CONTENTINFO_HANDLE. O cliente usa o identificador para recuperar informações de conteúdo.

Sintaxe

DWORD PeerDistServerOpenContentInformation(
  [in]           PEERDIST_INSTANCE_HANDLE     hPeerDist,
                 DWORD                        cbContentIdentifier,
  [in]           PBYTE                        pContentIdentifier,
                 ULONGLONG                    ullContentOffset,
                 ULONGLONG                    cbContentLength,
  [in, optional] HANDLE                       hCompletionPort,
  [in, optional] ULONG_PTR                    ulCompletionKey,
  [out]          PPEERDIST_CONTENTINFO_HANDLE phContentInfo
);

Parâmetros

[in] hPeerDist

Um PEERDIST_INSTANCE_HANDLE retornado por PeerDistStartup.

cbContentIdentifier

O comprimento, em bytes, do identificador de conteúdo.

[in] pContentIdentifier

Ponteiro para um buffer que contém o identificador de conteúdo.

ullContentOffset

Um deslocamento do início do conteúdo publicado para o qual o identificador de informações de conteúdo é solicitado.

cbContentLength

O comprimento, em bytes, do conteúdo (a partir do ullContentOffset) para o qual as informações de conteúdo são solicitadas.

[in, optional] hCompletionPort

Um identificador para a porta de conclusão usada 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. Este 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] phContentInfo

Um identificador usado para recuperar as informações de conteúdo.

Retornar valor

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.
PEERDIST_ERROR_NOT_FOUND
 Os dados especificados do identificador de conteúdo não são publicados.
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

Se a função for bem-sucedida, o identificador recebido por phContentInfo poderá ser passado para o
Função PeerDistServerRetrieveContentInformation para recuperar informações de conteúdo. O identificador deve ser fechado por meio da função PeerDistServerCloseContentInformation .

Se ullContentOffset e cbContentLength forem zero, as informações de conteúdo de todo o conteúdo serão recuperadas.

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

PeerDistServerRetrieveContentInformation