PeerDistServerOpenContentInformationEx, fonction (peerdist.h)

La fonction PeerDistServerOpenContentInformationEx ouvre une 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

Un PEERDIST_INSTANCE_HANDLE retourné 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 du 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 à renvoyer 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 transmis au
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 des informations de contenu.

Spécifications

Voir aussi

CreateIoCompletionPort

PEER_RETRIEVAL_OPTIONS

PeerDistServerCloseContentInformation

PeerDistServerRetrieveContentInformation

PeerDistStartup