IPipeLong::Pull method (objidl.h)
Retrieves data of the long integer type from the pipe source.
HRESULT Pull(
[out] LONG *buf,
[in] ULONG cRequest,
[out] ULONG *pcReturned
);
[out] buf
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.
[in] cRequest
The number of long integers requested.
[out] pcReturned
The actual number of long integers returned.
This method returns S_OK to indicate that the data was retrieved successfully.
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.
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | objidl.h (include ObjIdl.h) |