функция обратного вызова PGET_FIRST_ORDERED_SERVICE (stm.h)

Статья
03/05/2024

Функция 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
Header	stm.h

См. также раздел

CreateServiceEnumerationHandle

Управление таблицами службы IPX

IPX_SERVICE

Функции управления таблицами служб

Поделиться через