IPipeLong ::P ull, méthode (objidlbase.h)

Récupère les données du type entier long à partir de la source du canal.

Syntaxe

HRESULT Pull(
  [out] LONG  *buf,
  [in]  ULONG cRequest,
  [out] ULONG *pcReturned
);

Paramètres

[out] buf

Pointeur vers la mémoire tampon qui reçoit les données. La mémoire tampon doit être en mesure de contenir au moins le nombre d’entiers longs spécifiés dans cRequest.

[in] cRequest

Nombre d’entiers longs demandés.

[out] pcReturned

Nombre réel d’entiers longs retournés.

Valeur retournée

Cette méthode retourne S_OK pour indiquer que les données ont été récupérées avec succès.

Remarques

Lorsque la méthode Pull est appelée, les données sont demandées auprès du fournisseur du canal. L’appelant doit fournir une mémoire tampon qui contiendra au moins le nombre d’entiers longs spécifiés dans le paramètre cRequest . Le proxy démarshale les données dans la mémoire tampon fournie et définit le nombre d’entiers longs réellement fournis dans pcReturned. Le paramètre pcReturned peut être inférieur ou égal à cRequest, mais il ne sera jamais supérieur. Lorsque pcReturned a la valeur 0, cela indique qu’il n’y a plus de données.

Configuration requise

Voir aussi

IPipeLong