Edit

Share via

IPipeLong::Pull method (objidl.h)

  • Article

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

Syntax

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

Parameters

[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.

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

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)

See also

IPipeLong