Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

PCREATE_SERVICE_ENUMERATION_HANDLE callback function (stm.h)

The CreateServiceEnumerationHandle function returns a handle that allows the use of fast and change-tolerant enumeration functions. Such functions can scan through all services or a specified subset. The functions are change-tolerant in that they automatically enumerate any changes that other processes make to the set of enumerated services

Syntax

PCREATE_SERVICE_ENUMERATION_HANDLE PcreateServiceEnumerationHandle;

HANDLE PcreateServiceEnumerationHandle(
 [in] DWORD ExclusionFlags,
 [in] PIPX_SERVICE CriteriaService
)
{...}

Parameters

[in] ExclusionFlags

Specifies the limits the set of services that CreateServiceEnumerationHandle returns to a subset defined by a combination of ExclusionFlags and values in the corresponding members of CriteriaService. This parameter is one of the following values.

Value Meaning
STM_ONLY_THIS_INTERFACE
 Enumerate only those services that were obtained through the interface specified in the InterfaceIndex member of CriteriaService.
STM_ONLY_THIS_PROTOCOL
 Enumerate only those services that were obtained through the protocol specified in the Protocol member of CriteriaService. For example, IPX_PROTOCOL_SAP for services obtained by the DLL protocol or IPX_PROTOCOL_STATIC for services maintained by the router manager.
STM_ONLY_THIS_TYPE
 Enumerate only those services that have the same type as those in the Service member of CriteriaService

[in] CriteriaService

Pointer to an IPX_SERVICE structure with member values that correspond to those specified in ExclusionFlags.

Return value

If the function succeeds, the return value is a handle for use with the service enumeration function.

A NULL handle indicates no services exists with the specified criteria, or that the operation failed. For more information, call GetLastError and check the error code against the table below.

Value Description
ERROR_NO_SERVICES
 No services exist with 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

CloseServiceEnumerationHandle

EnumerateGetNextService

GetLastError

IPX Service Table Management

IPX_SERVICE

Service Table Management Functions

Feedback

Was this page helpful?

Additional resources

  • Last updated on