Compartilhar via


Função PeerDistServerOpenContentInformationEx (peerdist.h)

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

Sintaxe

DWORD PeerDistServerOpenContentInformationEx(
  [in]           PEERDIST_INSTANCE_HANDLE     hPeerDist,
  [in]           DWORD                        cbContentIdentifier,
  [in]           PBYTE                        pContentIdentifier,
                 ULONGLONG                    ullContentOffset,
                 ULONGLONG                    cbContentLength,
  [in]           PEERDIST_RETRIEVAL_OPTIONS   *pRetrievalOptions,
  [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.

[in] 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] pRetrievalOptions

Uma estrutura PEER_RETRIEVAL_OPTIONS especificando opções adicionais para recuperar informações de conteúdo.

[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.

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.

O parâmetro pRetrievalOptions pode ser usado para especificar o intervalo de versões de informações de conteúdo que o cliente solicitante está configurado para processar. Isso permite que o cliente recupere uma versão aplicável da estrutura de informações de conteúdo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho peerdist.h

Confira também

CreateIoCompletionPort

PEER_RETRIEVAL_OPTIONS

PeerDistServerCloseContentInformation

PeerDistServerRetrieveContentInformation

PeerDistStartup