Función PeerDistServerOpenContentInformation (peerdist.h)

  • Artículo

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

Sintaxis

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

Una PEERDIST_INSTANCE_HANDLE devuelta por PeerDistStartup.

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, 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. De lo contrario, es posible que la función devuelva uno de los siguientes valores:

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Uno o varios parámetros no son válidos.
ERROR_INVALID_HANDLE
 El identificador hPeerDist no es válido.
PEERDIST_ERROR_NOT_FOUND
 Los datos del identificador de contenido especificados no se publican.
ERROR_ACCESS_DISABLED_BY_POLICY
 La característica está deshabilitada por directiva de grupo.
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 El servicio no está disponible.

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.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado peerdist.h
Library PeerDist.lib
Archivo DLL PeerDist.dll

Consulte también

PeerDistServerRetrieveContentInformation