PeerDistClientOpenContent, fonction (peerdist.h)

Article
08/25/2023

La fonction PeerDistClientOpenContent s’ouvre et retourne un PEERDIST_CONTENT_HANDLE. Le client utilise le handle de contenu pour récupérer des données à partir du service peer distribution.

Syntaxe

DWORD PeerDistClientOpenContent(
  [in]           PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in]           PCPEERDIST_CONTENT_TAG   pContentTag,
  [in, optional] HANDLE                   hCompletionPort,
  [in, optional] ULONG_PTR                ulCompletionKey,
  [out]          PPEERDIST_CONTENT_HANDLE phContentHandle
);

Paramètres

[in] hPeerDist

Une PEERDIST_INSTANCE_HANDLE retournée par PeerDistStartup.

[in] pContentTag

Pointeur vers une structure PEERDIST_CONTENT_TAG qui contient un identificateur spécifié par le client de 16 octets. Ce paramètre est utilisé conjointement avec la fonction PeerDistClientFlushContent .

[in, optional] hCompletionPort

Handle vers le port d’achèvement qui peut être utilisé pour récupérer la notification d’achèvement de la fonction asynchrone. Pour créer un port d’achèvement, utilisez la fonction CreateIoCompletionPort Ce paramètre peut être NULL.

[in, optional] ulCompletionKey

Valeur à retourner via le paramètre lpCompletionKey de la fonction GetQueuedCompletionStatus . Ce paramètre est ignoré lorsque hCompletionPort a la valeur NULL.

[out] phContentHandle

Pointeur vers une variable qui reçoit les PEERDIST_CONTENT_HANDLE utilisées pour récupérer ou ajouter des données.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS. 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 n’est pas valide.
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.

Notes

Le client doit appeler la fonction PeerDistClientOpenContent pour obtenir un handle PEERDIST_CONTENT_HANDLE qui pourra être utilisé ultérieurement dans les fonctions suivantes :

Si un handle de port d’achèvement facultatif est spécifié, il est utilisé pour publier les résultats d’achèvement des fonctions asynchrones répertoriées ci-dessus.

Le handle retourné par l’appel de fonction PeerDistClientOpenContent doit être fermé par la fonction PeerDistClientCloseContent .

Spécifications


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