Compartir a través de

Función PeerDistClientAddData (peerdist.h)

  • Artículo

La función PeerDistClientAddData se usa para proporcionar contenido a la memoria caché local. Normalmente, esto se hace cuando no se pudieron encontrar datos en la red local, como se indica cuando PeerDistClientBlockRead o PeerDistClientStreamRead se completan con ERROR_TIMEOUT o PEERDIST_ERROR_MISSING_DATA.

Sintaxis

DWORD PeerDistClientAddData(
  [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 devuelto por PeerDistClientOpenContent.

cbNumberOfBytes

Número de bytes que se van a agregar a la memoria caché local.

[in] pBuffer

Puntero al búfer que contiene los datos que se van a agregar a la caché local. 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 desplazamiento de bytes desde el principio del contenido, en el que se agregan estos datos, se especifica estableciendo los miembros Offset y OffsetHigh de la estructura SUPERPUESTA . El miembro OffsetHigh DEBE establecerse en los 32 bits superiores del desplazamiento de bytes y el miembro Offset DEBE establecerse en los 32 bits inferiores del desplazamiento de bytes.

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 o hContent 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

Los datos que se han agregado con esta función y que se han pasado la comprobación están disponibles para otros sistemas del mismo nivel o la memoria caché hospedada para su descarga. El servicio de distribución del mismo nivel almacena estos datos en su caché local.

Si la API se completa con PEERDIST_ERROR_OUT_OF_BOUNDS, esto indica que el desplazamiento especificado en la estructura superpuesta está más allá del final del 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

PeerDistClientBlockRead

PeerDistClientStreamRead

PeerDistStartup