IPipeLong::Pull method

Retrieves data of the long integer type from the pipe source.

Syntax


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

Parameters

buf [out]

A pointer to the memory buffer that receives the data. The buffer must be able to hold at least the number of long integers specified in cRequest.

cRequest [in]

The number of long integers requested.

pcReturned [out]

The actual number of long integers returned.

Return value

This method returns S_OK to indicate that the data was retrieved successfully.

Remarks

When the Pull method is called, data is requested from the provider of the pipe. The caller must provide a buffer that will hold at least the number of long integers specified in the cRequest parameter. The proxy will unmarshal the data into the provided buffer and set the number of long integers actually provided in pcReturned. The pcReturned parameter can be less than or equal to cRequest, but it will never be greater. When pcReturned is 0, it indicates that there is no more data.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IPipeLong is defined as DB2F3ACD-2F86-11d1-8E04-00C04FB9989A

See also

IPipeLong

 

 

Show: