Método IPipeByte::P ull (objidlbase.h)

Recupera dados do tipo de byte da origem do pipe.

Sintaxe

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

Parâmetros

[out] buf

Um ponteiro para o buffer de memória que recebe os dados. O buffer deve ser capaz de conter pelo menos o número de bytes especificados em cRequest.

[in] cRequest

O número de bytes solicitados.

[out] pcReturned

O número real de bytes retornados.

Retornar valor

Esse método retorna S_OK para indicar que os dados foram recuperados com êxito.

Comentários

Quando o método Pull é chamado, os dados são solicitados do provedor do pipe. O chamador deve fornecer um buffer que conterá pelo menos o número de bytes especificados no parâmetro cRequest . O proxy desmarcará os dados no buffer fornecido e definirá o número de bytes realmente fornecidos no pcReturned. O parâmetro pcReturned pode ser menor ou igual a cRequest, mas nunca será maior. Quando pcReturned é 0, indica que não há mais dados.

Requisitos

Confira também

IPipeByte