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


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

Функция CreateServiceEnumerationHandle возвращает дескриптор, который позволяет использовать быстрые и устойчивые к изменениям функции перечисления. Такие функции могут проверять все службы или указанное подмножество. Функции устойчивы к изменениям в том, что они автоматически перечисляют любые изменения, которые другие процессы вносят в набор перечисленных служб.

Синтаксис

PCREATE_SERVICE_ENUMERATION_HANDLE PcreateServiceEnumerationHandle;

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

Параметры

[in] ExclusionFlags

Задает ограничение набора служб, возвращаемых CreateServiceEnumerationHandle , подмножеством, определенным сочетанием ExclusionFlags и значений в соответствующих членах CriteriaService. Этот параметр является одним из следующих значений.

Значение Значение
STM_ONLY_THIS_INTERFACE
Перечислять только те службы, которые были получены через интерфейс, указанный в элементе InterfaceIndexэлемента CriteriaService.
STM_ONLY_THIS_PROTOCOL
Перечислять только те службы, которые были получены по протоколу, указанному в элементе протоколаCriteriaService. Например, 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
Header stm.h

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

CloseServiceEnumerationHandle

EnumerateGetNextService

Getlasterror

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

IPX_SERVICE

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