Edit

PENUMERATE_GET_NEXT_SERVICE callback function (stm.h)

  • Article

The EnumerateGetNextService function returns the next service entry in an enumeration started by CreateServiceEnumerationHandle.

Syntax

PENUMERATE_GET_NEXT_SERVICE PenumerateGetNextService;

DWORD PenumerateGetNextService(
  [in]  HANDLE EnumerationHandle,
  [out] PIPX_SERVICE Service
)
{...}

Parameters

[in] EnumerationHandle

Handle that identifies the enumeration and specifies the subset of services on which the enumeration will operate. The handle is obtained from a call to CreateServiceEnumerationHandle.

[out] Service

Pointer to an IPX_SERVICE structure that contains the next service in the enumeration. The services are returned in no particular order, and each service in the subset is returned only once.

Return value

If the function succeeds, the buffer pointed to by the Service parameter receives the next service in the enumeration. In this case 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_ITEMS
 No more services exist with the specified criteria.
ERROR_CAN_NOT_COMPLETE
 The operation failed.
 
 

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