PeerDistServerOpenContentInformation, fonction (peerdist.h)

Article
03/01/2024

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

Syntaxe

DWORD PeerDistServerOpenContentInformation(
  [in]           PEERDIST_INSTANCE_HANDLE     hPeerDist,
                 DWORD                        cbContentIdentifier,
  [in]           PBYTE                        pContentIdentifier,
                 ULONGLONG                    ullContentOffset,
                 ULONGLONG                    cbContentLength,
  [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.

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, 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. 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.
PEERDIST_ERROR_NOT_FOUND	Les données d’identificateur de contenu spécifiées ne sont pas publiées.
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

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.

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

PeerDistServerRetrieveContentInformation

Partager via