PCREATE_SERVICE_ENUMERATION_HANDLE回调函数 (stm.h)

CreateServiceEnumerationHandle 函数返回一个句柄，该句柄允许使用快速且可更改的枚举函数。 此类函数可以扫描所有服务或指定的子集。 函数具有可更改性，因为它们会自动枚举其他进程对枚举服务集所做的任何更改

语法

PCREATE_SERVICE_ENUMERATION_HANDLE PcreateServiceEnumerationHandle;

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

参数

[in] ExclusionFlags

指定 CreateServiceEnumerationHandle 返回到由 CriteriaService 相应成员中的 ExclusionFlags 和值组合定义的子集的限制。 此参数是以下值之一。

值	含义
STM_ONLY_THIS_INTERFACE	仅枚举通过 CriteriaService 的 InterfaceIndex 成员中指定的接口获取的服务。
STM_ONLY_THIS_PROTOCOL	仅枚举通过 CriteriaService 的 Protocol 成员中指定的协议获取的服务。 例如，IPX_PROTOCOL_SAP DLL 协议获取的服务;对于路由器管理器维护的服务IPX_PROTOCOL_STATIC。
STM_ONLY_THIS_TYPE	仅枚举与 CriteriaService 服务成员中类型相同的服务

[in] CriteriaService

指向 IPX_SERVICE 结构的指针，该结构的成员值对应于 在 ExclusionFlags 中指定的值。

返回值

如果函数成功，则返回值是用于服务枚举函数的句柄。

NULL 句柄指示不存在具有指定条件的服务，或者操作失败。 有关详细信息，请调用 GetLastError 并针对下表检查错误代码。

值	说明
ERROR_NO_SERVICES	不存在具有指定条件的服务。
ERROR_INVALID_PARAMETER	其中一个参数无效。

 

 

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	stm.h

另请参阅

CloseServiceEnumerationHandle

EnumerateGetNextService

GetLastError

IPX 服务表管理

IPX_SERVICE

服务表管理功能