Share via

IEnumNmCall::Next

  • Article

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

HRESULT Next(
ULONG cCall,INmCall **rgpCall,ULONG *pcFetched);

Parameters

  • cCall
    [in] Number of INmCall interface pointers to retrieve.
  • rgpCall
    [out] Pointer to the location of an array for retrieved INmCall interface pointers.
  • pcFetched
    [out] Pointer to the actual number of INmCall interface pointers placed in the array specified by rgpCall. This may be set to NULL, in which case cCall 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 IEnumNmCall interfaces to retrieve.
  • E_INVALIDARG
    pcFetched is NULL but cCall is not 1.

Remarks

The INmCall 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

INmManager::EnumCall, INmCall, Call Object, Call Object Details