Edit

PGET_NEXT_ORDERED_SERVICE callback function (stm.h)

  • Article

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.

Syntax

PGET_NEXT_ORDERED_SERVICE PgetNextOrderedService;

DWORD PgetNextOrderedService(
  [in]      DWORD OrderingMethod,
  [in]      DWORD ExclusionFlags,
  [in, out] PIPX_SERVICE Service
)
{...}

Parameters

[in] OrderingMethod

Specifies the order in which the services are searched. See GetFirstOrderedService for a description of the various ordering methods.

[in] ExclusionFlags

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

[in, out] Service

Pointer to an IPX_SERVICE structure.

On input, specifies the service from which to continue searching; also contains member values that correspond to the specified ExclusionFlags.

On output, the structure contains the first service that follows the input service and matches the specified criteria.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value Description
ERROR_NO_MORE_SERVICES
 There are no more services matching the specified criteria.
ERROR_INVALID_PARAMETER
 One of the parameters is invalid.
 
 

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header stm.h

See also

CreateServiceEnumerationHandle

IPX Service Table Management

IPX_SERVICE

Service Table Management Functions