PeerDistServerRetrieveContentInformation, fonction (peerdist.h)

Article
03/01/2024

La fonction PeerDistServerRetrieveContentInformation récupère les informations de contenu encodées associées à un handle retourné par PeerDistServerOpenContentInformation.

Syntaxe

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

Paramètres

[in] hPeerDist

Une PEERDIST_INSTANCE_HANDLE retournée par PeerDistStartup.

[in] hContentInfo

Handle retourné par PeerDistServerOpenContentInformation.

cbMaxNumberOfBytes

Nombre maximal d'octets à lire.

[in, out] pBuffer

Pointeur vers la mémoire tampon qui reçoit les données d’informations de contenu.

[in] lpOverlapped

Pointeur vers une structure CHEVAUCHÉE . Cette fonction n’autorise pas l’appelant à spécifier le décalage de début dans le contenu. Le décalage est implicitement géré par hContentInfo. Les valeurs Offset et OffsetHigh sont réservées et doivent être égales à zéro.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_IO_PENDING. Sinon, la fonction peut retourner l’une des valeurs suivantes :

Code de retour	Description
ERROR_INVALID_PARAMETER	Un ou plusieurs paramètres ne sont pas valides.
ERROR_INVALID_HANDLE	Le handle hPeerDist ou hContentInfo n’est pas valide.
PEERDIST_ERROR_NO_MORE	EOF sur les informations de contenu a été atteint.
ERROR_ACCESS_DISABLED_BY_POLICY	La fonctionnalité est désactivée par stratégie de groupe.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	Le service n’est pas disponible.

Remarques

En cas de réussite de l’opération PeerDistServerRetrieveContentInformation , les champs Offset et OffsetHigh de la structure OVERLAPPED sont renseignés avec le décalage ULONGLONG dans les informations de contenu récupérées. Le membre OffsetHigh est défini sur les 32 bits les plus élevés du décalage et le membre Offset est défini sur les 32 bits inférieurs du décalage.

GetOverlappedResult remplit lpNumberOfBytesTransferred avec le nombre d’octets transférés. Dans le cas où l’appelant utilise un port d’achèvement pour traiter les achèvements de l’API De distribution d’homologues, l’argument lpNumberOfBytes de GetQueuedCompletionStatus est rempli avec le nombre d’octets transférés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	peerdist.h
Bibliothèque	PeerDist.lib
DLL	PeerDist.dll

Voir aussi

PeerDistServerOpenContentInformation

PeerDistStartup

Partager via