PeerDistServerOpenContentInformationEx, fonction (peerdist.h)

Article
03/04/2024

La fonction PeerDistServerOpenContentInformationEx ouvre un PEERDIST_CONTENTINFO_HANDLE. Le client utilise le handle pour récupérer des informations de contenu.

Syntaxe

DWORD PeerDistServerOpenContentInformationEx(
  [in]           PEERDIST_INSTANCE_HANDLE     hPeerDist,
  [in]           DWORD                        cbContentIdentifier,
  [in]           PBYTE                        pContentIdentifier,
                 ULONGLONG                    ullContentOffset,
                 ULONGLONG                    cbContentLength,
  [in]           PEERDIST_RETRIEVAL_OPTIONS   *pRetrievalOptions,
  [in, optional] HANDLE                       hCompletionPort,
  [in, optional] ULONG_PTR                    ulCompletionKey,
  [out]          PPEERDIST_CONTENTINFO_HANDLE phContentInfo
);

Paramètres

[in] hPeerDist

Une PEERDIST_INSTANCE_HANDLE retournée par PeerDistStartup.

[in] cbContentIdentifier

Longueur, en octets, de l’identificateur de contenu.

[in] pContentIdentifier

Pointeur vers une mémoire tampon qui contient l’identificateur de contenu.

ullContentOffset

Décalage par rapport au début du contenu publié pour lequel le handle d’informations de contenu est demandé.

cbContentLength

Longueur, en octets, du contenu (à partir de l’ullContentOffset) pour lequel les informations de contenu sont demandées.

[in] pRetrievalOptions

Structure PEER_RETRIEVAL_OPTIONS spécifiant des options supplémentaires pour récupérer des informations de contenu.

[in, optional] hCompletionPort

Handle vers le port d’achèvement 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] phContentInfo

Handle utilisé pour récupérer les informations de contenu.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Remarques

Si la fonction réussit, le handle reçu par phContentInfo peut être passé à la
Fonction PeerDistServerRetrieveContentInformation pour récupérer des informations de contenu. Le handle doit être fermé via la fonction PeerDistServerCloseContentInformation .

Si ullContentOffset et cbContentLength sont tous deux zéro, les informations de contenu pour l’ensemble du contenu sont récupérées.

Le paramètre pRetrievalOptions peut être utilisé pour spécifier la plage de versions d’informations de contenu que le client demandeur est configuré pour traiter. Cela permet au client de récupérer une version applicable de la structure d’informations de contenu.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	peerdist.h

Voir aussi

CreateIoCompletionPort

PEER_RETRIEVAL_OPTIONS

PeerDistServerCloseContentInformation

PeerDistServerRetrieveContentInformation

PeerDistStartup

Partager via