Compartilhar via


Método IPipeByte::P ull (objidl.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 especificado 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 especificado no parâmetro cRequest . O proxy cancelará a gravação dos dados no buffer fornecido e definirá o número de bytes realmente fornecidos em 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

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objidl.h (inclua ObjIdl.h)

Confira também

IPipeByte