Compartilhar via


Método IPipeLong::P ull (objidl.h)

Recupera dados do tipo inteiro longo da origem do pipe.

Sintaxe

HRESULT Pull(
  [out] LONG  *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 inteiros longos especificados em cRequest.

[in] cRequest

O número de inteiros longos solicitados.

[out] pcReturned

O número real de inteiros longos retornados.

Valor retornado

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 inteiros longos especificados no parâmetro cRequest . O proxy desmarcará os dados no buffer fornecido e definirá o número de inteiros longos 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

   
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

IPipeLong