Функция GetSharedServiceRegistryStateKey (winsvc.h)
Возвращает дескриптор для раздела реестра для службы и связанных программ для чтения и (или) записи состояния.
Синтаксис
DWORD GetSharedServiceRegistryStateKey(
SC_HANDLE ServiceHandle,
SERVICE_SHARED_REGISTRY_STATE_TYPE StateType,
DWORD AccessMask,
HKEY *ServiceStateKey
);
Параметры
ServiceHandle
StateType
Член SERVICE_SHARED_REGISTRY_STATE_TYPE , указывающий тип общего состояния, для которого извлекается раздел реестра службы.
AccessMask
Маска доступа, с помощью которой выполняется попытка открыть ключ состояния. Дополнительные сведения см. в разделе Безопасность раздела реестра и права доступа.
ServiceStateKey
Получает дескриптор раздела реестра выходных данных.
Возвращаемое значение
ERROR_SUCCESS после успешного завершения всех операций; в противном случае — код ошибки Win32.
Комментарии
Для ServiceSharedRegistryStatePersistent безопасность каталога предоставляет доступ на запись только к учетной записи локальной системы, идентификатору безопасности службы и локальным администраторам. Убедитесь, что идентификаторы безопасности служб включены для любой службы, которая вызывает этот API. Дополнительные сведения см. в разделе SERVICE_SID_INFO.
Аналогичный API, предоставляющий состояние службы исключительно для использования самой службой, см. в разделе GetServiceRegistryStateKey.
Все разделы реестра состояния службы удаляются диспетчером управления службами после удаления службы.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 11 (сборка 22000) |
| Минимальная версия сервера | Windows Server 2022 (сборка 20348) |
| Верхняя часть | winsvc.h |
| Библиотека | Onecore.lib |