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

Récupère les données du type d’octet à partir de la source de canal.

Syntaxe

HRESULT Pull(
  [out] BYTE  *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’octets spécifié dans cRequest.

[in] cRequest

Nombre d’octets demandés.

[out] pcReturned

Nombre réel d’octets 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’octets spécifié dans le paramètre cRequest . Le proxy désactive les données dans la mémoire tampon fournie et définit le nombre d’octets 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

IPipeByte