Método IPipeLong::P ull (objidlbase.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.

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 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 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	objidlbase.h (inclua ObjIdl.h)

Confira também

IPipeLong