Función PeerDistClientAddContentInformation (peerdist.h)

La función PeerDistClientAddContentInformation agrega la información de contenido asociada a un identificador de contenido abierto por PeerDistClientOpenContent.

Sintaxis

DWORD PeerDistClientAddContentInformation(
  [in] PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in] PEERDIST_CONTENT_HANDLE  hContentHandle,
       DWORD                    cbNumberOfBytes,
  [in] PBYTE                    pBuffer,
  [in] LPOVERLAPPED             lpOverlapped
);

Parámetros

[in] hPeerDist

Un PEERDIST_INSTANCE_HANDLE devuelto por PeerDistStartup.

[in] hContentHandle

Un PEERDIST_CONTENT_HANDLE abierto por PeerDistClientOpenContent.

cbNumberOfBytes

Número de bytes de la matriz pBuffer .

[in] pBuffer

Puntero al búfer que contiene la información de contenido. Este búfer debe permanecer válido durante la operación de adición. El autor de la llamada no debe usar este búfer hasta que se complete la operación de adición.

[in] lpOverlapped

Puntero a una estructura SUPERPUESTA . El miembro interno de la estructura SUPERPUESTA contiene el estado de finalización de la operación asincrónica. Offset y OffsetHigh están reservados y deben ser 0.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto se ERROR_IO_PENDING. 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.
ERROR_ACCESS_DISABLED_BY_POLICY	La característica está deshabilitada por directiva de grupo.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	El servicio no está disponible.

Comentarios

Para recuperar datos de contenido del servicio de distribución del mismo nivel, el cliente debe agregar información de contenido que recibió del servidor de contenido mediante una llamada a la función PeerDistClientAddContentInformation . Cuando se han agregado todos los datos de información de contenido, se debe llamar a la función PeerDistClientCompleteContentInformation . Una vez completado PeerDistClientCompleteContentInformation , el cliente puede llamar a PeerDistClientStreamRead o PeerDistClientBlockRead para recuperar los datos del sistema de distribución del mismo nivel.

Al llamar a esta función varias veces en un único identificador de contenido, el autor de la llamada debe esperar a que se complete cada operación antes de que se realice la siguiente llamada.

Una aplicación no se limita a agregar información de contenido con una sola llamada API PeerDistClientAddContentInformation , ya que es posible agregar partes de esa información de contenido tal como está disponible. Cuando hay más información de contenido disponible, la aplicación puede llamar de nuevo a PeerDistClientAddContentInformation. Cuando la aplicación haya terminado de agregar toda la información de contenido, debe llamar a PeerDistClientCompleteContentInformation.

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

PeerDistClientCompleteContentInformation

PeerDistClientOpenContent

PeerDistStartup