Función PeerDistServerOpenContentInformationEx (peerdist.h)

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

Syntax

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

Un PEERDIST_INSTANCE_HANDLE devuelto 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 mediante el 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, se ERROR_SUCCESS el valor devuelto.

Observaciones

Si la función se realiza correctamente, el identificador recibido por phContentInfo se puede pasar al
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

Consulte también

CreateIoCompletionPort

PEER_RETRIEVAL_OPTIONS

PeerDistServerCloseContentInformation

PeerDistServerRetrieveContentInformation

PeerDistStartup