IEnumNmCall::Next
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