PENUMERATE_GET_NEXT_SERVICE callback function (stm.h)

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.

Requirements

See also

CreateServiceEnumerationHandle

IPX Service Table Management

IPX_SERVICE

Service Table Management Functions