通过

PGET_FIRST_ORDERED_SERVICE回调函数 (stm.h)

  • 项目

GetFirstOrderedService 函数以指定顺序从表中指定的服务子集返回第一个服务。

语法

PGET_FIRST_ORDERED_SERVICE PgetFirstOrderedService;

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

参数

[in] OrderingMethod

指定搜索服务的顺序。 此参数须为下列值之一。

值 含义
STM_ORDER_BY_TYPE_AND_NAME
 先按类型搜索服务，然后按名称搜索服务。
STM_ORDER_BY_INTERFACE_TYPE_NAME
 首先按接口索引搜索服务，然后按类型搜索服务，最后按名称搜索。

[in] ExclusionFlags

指定将检查的服务集限制为 由 ExclusionFlags 定义的子集，以及 Service 参数指向的结构成员中的值。 有关可能标志的说明，请参阅 CreateServiceEnumerationHandle 。

[in, out] Service

指向 IPX_SERVICE 结构的指针。

输入时，成员中的值对应于 ExclusionFlags 中指定的标志。

输出时，第一个与指定条件匹配的服务。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值 说明
ERROR_NO_MORE_ITEMS
 与指定条件匹配的服务不存在。
ERROR_INVALID_PARAMETER
 其中一个参数无效。
 
 

要求

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

另请参阅

CreateServiceEnumerationHandle

IPX 服务表管理

IPX_SERVICE

服务表管理功能