Функция GetServiceRegistryStateKey (winsvc.h)
Возвращает дескриптор раздела реестра для службы, в который считывается и (или) записывается состояние.
Синтаксис
DWORD GetServiceRegistryStateKey(
SERVICE_STATUS_HANDLE ServiceStatusHandle,
SERVICE_REGISTRY_STATE_TYPE StateType,
DWORD AccessMask,
HKEY *ServiceStateKey
);
Параметры
ServiceStatusHandle
Дескриптор структуры сведений о состоянии для текущей службы. Этот дескриптор возвращается функцией RegisterServiceCtrlHandler .
StateType
Член SERVICE_REGISTRY_STATE_TYPE , указывающий тип состояния, для которого выполняется восстановление раздела реестра службы.
AccessMask
Маска доступа, с помощью которой выполняется попытка открыть ключ состояния. Дополнительные сведения см. в разделе Безопасность раздела реестра и права доступа.
ServiceStateKey
Получает дескриптор раздела реестра выходных данных.
Возвращаемое значение
ERROR_SUCCESS после успешного завершения всех операций; в противном случае — код ошибки Win32.
Комментарии
Для ServiceRegistryStatePersistent безопасность каталога настроена таким образом, чтобы предоставить доступ на запись только к локальной системной учетной записи и идентификатору безопасности службы. Убедитесь, что идентификаторы безопасности служб включены для любой службы, которая вызывает этот API. Дополнительные сведения см. в разделе SERVICE_SID_INFO.
Аналогичный API, предоставляющий состояние службы, который может быть предоставлен совместно со связанными программами, см. в разделе GetSharedServiceRegistryStateKey.
Все разделы реестра состояния службы удаляются диспетчером управления службами после удаления службы.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10, версия 2004 (10.0; Сборка 19041) |
| Минимальная версия сервера | Windows Server версии 2004 (10.0; Сборка 19041) |
| Верхняя часть | winsvc.h |
| Библиотека | Onecore.lib |