IEnumClusCfgIPAddresses::Next method

[This method is available for use only in Windows Server 2003.]

Retrieves the next cNumberRequestedIn items in the IEnumClusCfgIPAddresses enumeration sequence. If there are fewer than the requested number of elements left in the sequence, it retrieves the remaining elements. The number of elements actually retrieved is returned through the pcNumberFetchedOut parameter (unless the caller passed in NULL for that parameter).

Syntax

HRESULT Next(
  [in]  ULONG                 cNumberRequestedIn,
  [out] IClusCfgIPAddressInfo **rgpIPAddressInfoOut,
  [out] ULONG                 *pcNumberFetchedOut
);

Parameters

  • cNumberRequestedIn [in]
    number of elements being requested.

  • rgpIPAddressInfoOut [out]
    Array of size cNumberRequestedIn (or larger) of the elements of interest. The type of this parameter depends on the item being enumerated.

  • pcNumberFetchedOut [out]
    Pointer to the number of elements actually supplied in the rgpIPAddressInfoOut parameter. Caller can pass in NULL if cNumberRequestedIn is one.

Return value

The Next method returns one of the following values:

Any other HRESULT value indicates that the call failed.

  • S_OK.
    The method successfully retrieved the items, and the number of items supplied is cNumberRequestedIn.

  • S_FALSE
    The number of items supplied is not cNumberRequestedIn.

Remarks

There is no more data to enumerate when the pcNumberFetchedOut parameter is zero and HRESULT is S_FALSE.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003

End of server support

Windows Server 2003

IDL

ClusCfgServer.idl

DLL

ClCfgSrv.dll

IID

IID_IEnumClusCfgIPAddresses is defined as BD5F35BA-0BC0-455F-926D-C3D356419486

See also

IEnumClusCfgIPAddresses