Función PeerDistServerRetrieveContentInformation (peerdist.h)

  • Artículo

La función PeerDistServerRetrieveContentInformation recupera la información de contenido codificada asociada a un identificador devuelto por PeerDistServerOpenContentInformation.

Sintaxis

DWORD PeerDistServerRetrieveContentInformation(
  [in]      PEERDIST_INSTANCE_HANDLE    hPeerDist,
  [in]      PEERDIST_CONTENTINFO_HANDLE hContentInfo,
            DWORD                       cbMaxNumberOfBytes,
  [in, out] PBYTE                       pBuffer,
  [in]      LPOVERLAPPED                lpOverlapped
);

Parámetros

[in] hPeerDist

Una PEERDIST_INSTANCE_HANDLE devuelta por PeerDistStartup.

[in] hContentInfo

Identificador devuelto por PeerDistServerOpenContentInformation.

cbMaxNumberOfBytes

Número máximo de bytes que se pueden leer.

[in, out] pBuffer

Puntero al búfer que recibe los datos de información de contenido.

[in] lpOverlapped

Puntero a una estructura SUPERPUESTA . Esta función no permite al autor de la llamada especificar el desplazamiento inicial en el contenido. El desplazamiento se mantiene implícitamente por hContentInfo. Offset y OffsetHigh están reservados y deben ser cero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es 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 hContentInfo no es válido.
PEERDIST_ERROR_NO_MORE
 Se ha alcanzado EOF en la información de contenido.
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 se ejecuta correctamente la operación PeerDistServerRetrieveContentInformation, los campos Offset y OffsetHigh de la estructura SUPERPUESTA se rellenarán con el desplazamiento de ULONGLONG en la información de contenido que se recuperó. El miembro OffsetHigh se establecerá en los 32 bits superiores del desplazamiento y el miembro Offset se establecerá en los 32 bits inferiores del desplazamiento.

GetOverlappedResult rellenará lpNumberOfBytesTransferred con el número de bytes transferidos. En caso de que el autor de la llamada use un puerto de finalización para procesar finalizaciones de la API de distribución del mismo nivel, el argumento lpNumberOfBytes de GetQueuedCompletionStatus se rellenará con el número de bytes transferidos.

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

PeerDistServerOpenContentInformation

PeerDistStartup