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

Статья
08/26/2023

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

Синтаксис

PENUMERATE_GET_NEXT_SERVICE PenumerateGetNextService;

DWORD PenumerateGetNextService(
  [in]  HANDLE EnumerationHandle,
  [out] PIPX_SERVICE Service
)
{...}

Параметры

[in] EnumerationHandle

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

[out] Service

Указатель на структуру IPX_SERVICE , содержащую следующую службу в перечислении. Службы возвращаются не в определенном порядке, а каждая служба в подмножестве возвращается только один раз.

Возвращаемое значение

Если функция выполняется успешно, буфер, на который указывает параметр Service , получает следующую службу в перечислении . В этом случае возвращаемое значение равно NO_ERROR.

Если функция завершается сбоем, возвращается один из следующих кодов ошибок.

Значение	Описание
ERROR_NO_MORE_ITEMS	Больше не существует служб с указанными критериями.
ERROR_CAN_NOT_COMPLETE	Операция не удалась.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	stm.h

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

CreateServiceEnumerationHandle

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

IPX_SERVICE

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

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