Share via

IEnumNmChannel::Next

  • Article

Use the Next method to retrieve the specified number of INmChannel interfaces in the enumeration sequence.

HRESULT Next(
ULONG cChannel,INmChannel **rgpChannel,ULONG *pcFetched);

Parameters

  • cChannel
    [in] Number of INmChannel interface pointers to retrieve.
  • rgpChannel
    [out] Pointer to the location of an array for retrieved INmChannel interface pointers.
  • pcFetched
    [out] Pointer to the actual number of INmChannel interface pointers in the array specified by rgpChannel. This may be set to NULL, in which case cChannel must be 1.

Return Values

NetMeeting client applications can use the SUCCEEDED and FAILED macros in winerror.h to check return values.

Return values can include remote procedure call (RPC) layer errors or any of the following values.

  • S_OK
    Retrieved the indicated number of interface pointers successfully.
  • S_FALSE
    There are no more INmChannel interfaces to retrieve.
  • E_INVALIDARG
    pcFetched is NULL but cChannel is not 1.

Remarks

The INmChannel interfaces returned by this method have had their reference count incremented. The application should call the Release method on the interfaces to decrement the reference count when it has finished using the interfaces.

Requirements

**  Windows NT/2000:** Requires Windows NT 4.0 SP3 or later.
**  Windows 95/98:** Requires Windows 95 or later. Available as a redistributable for Windows 95.
**  Header:** Imsconf2.idl.

See Also

INmConference::EnumChannel, INmChannel, Channel Object, Channel Object Details