Функция QueryServiceDynamicInformation (winsvc.h)

Статья
03/04/2024

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

Синтаксис

BOOL QueryServiceDynamicInformation(
  [in] SERVICE_STATUS_HANDLE hServiceStatus,
  [in] DWORD                 dwInfoLevel,
       PVOID                 *ppDynamicInfo
);

Параметры

[in] hServiceStatus

Дескриптор состояния службы, предоставляемый RegisterServiceCtrlHandlerEx.

[in] dwInfoLevel

Указывает уровень сведений.

Значение	Значение
SERVICE_DYNAMIC_INFORMATION_LEVEL_START_REASON	Указывает запрос на получение динамических сведений, связанных с текущим запуском службы.

ppDynamicInfo

Динамический информационный буфер. Если этот параметр является допустимым, функция обратного вызова должна освободить буфер после использования с функцией LocalFree .

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

Если функция выполняется успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE. В этом случае необходимо вызвать функцию GetLastError , чтобы получить код ошибки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	winsvc.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll