Compartir a través de

Función PeerDistServerOpenContentInformationEx (peerdist.h)

  • Artículo

La función PeerDistServerOpenContentInformationEx abre un PEERDIST_CONTENTINFO_HANDLE. El cliente usa el identificador para recuperar información de contenido.

Sintaxis

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

Una PEERDIST_INSTANCE_HANDLE devuelta por PeerDistStartup.

[in] cbContentIdentifier

Longitud, en bytes, del identificador de contenido.

[in] pContentIdentifier

Puntero a un búfer que contiene el identificador de contenido.

ullContentOffset

Desplazamiento desde el principio del contenido publicado para el que se solicita el identificador de información de contenido.

cbContentLength

Longitud, en bytes, del contenido (a partir de ullContentOffset) para el que se solicita la información de contenido.

[in] pRetrievalOptions

Estructura de PEER_RETRIEVAL_OPTIONS que especifica opciones adicionales para recuperar información de contenido.

[in, optional] hCompletionPort

Identificador del puerto de finalización usado para recuperar la notificación de finalización de la función asincrónica. Para crear un puerto de finalización, use la función CreateIoCompletionPort. Este parámetro puede ser NULL.

[in, optional] ulCompletionKey

Valor que se va a devolver a través del parámetro lpCompletionKey de la función GetQueuedCompletionStatus . Este parámetro se omite cuando hCompletionPort es NULL.

[out] phContentInfo

Identificador usado para recuperar la información de contenido.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Comentarios

Si la función se ejecuta correctamente, el identificador recibido por phContentInfo se puede pasar a .
Función PeerDistServerRetrieveContentInformation para recuperar información de contenido. El identificador debe cerrarse a través de la función PeerDistServerCloseContentInformation .

Si ullContentOffset y cbContentLength son cero, se recuperará la información de contenido de todo el contenido.

El parámetro pRetrievalOptions se puede usar para especificar el intervalo de versiones de información de contenido que el cliente solicitante está configurado para procesar. Esto permite al cliente recuperar una versión aplicable de la estructura de información de contenido.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado peerdist.h

Consulte también

CreateIoCompletionPort

PEER_RETRIEVAL_OPTIONS

PeerDistServerCloseContentInformation

PeerDistServerRetrieveContentInformation

PeerDistStartup