GetNextOrderedService

[This is preliminary documentation and subject to change.]

The GetNextOrderedService function returns the next service from a subset of services in the table. The service returned is the next service after a given input service using the ordering method specified.

DWORD GetNextOrderedService (
  IN DWORD               OrderingMethod,
  IN DWORD               ExclusionFlags,
  IN OUT PIPX_SERVICE    Service
  );
 

Parameters

OrderingMethod

Indicates the order in which the services will be searched. See GetFirstOrderedService for a description of the various ordering methods.

ExclusionFlags

Limits the set of examined services to a subset defined by ExclusionFlags and the values in the corresponding fields of Service. See CreateServiceEnumerationHandle for a description of the possible flags.

Service

Points to an IPX_SERVICE structure.

Value of Service at Input:

Contains the service from which to continue searching; also contains field values that correspond to the specified ExclusionFlags.

Value of Service upon Output:

The structure contains the first service that follows the input service and matches the specified criteria.

Return Values

NO_ERROR

The next matching service was found and placed in the structure pointed to by Service.

ERROR_NO_MORE_SERVICES

No more services matching the specified criteria exist.

ERROR_INVALID_PARAMETER

One or more of the input parameters is invalid; for example, invalid ordering method, enumeration flags, or field values in Service.

QuickInfo

  Windows NT: Use version 5.0 and later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in user-defined.
  Import Library: user-defined.

See Also

CreateServiceEnumerationHandle, IPX_SERVICE