Функция ResUtilSetResourceServiceEnvironment (resapi.h)
Корректирует данные среды для службы таким образом, чтобы служба использовала сетевое имя кластера для определения своего расположения. Эта функция должна вызываться из библиотеки DLL ресурса. Тип PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT определяет указатель на эту функцию.
Синтаксис
DWORD ResUtilSetResourceServiceEnvironment(
[in] LPCWSTR pszServiceName,
[in] HRESOURCE hResource,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
Параметры
[in] pszServiceName
Указатель на строку Юникода с пустым завершением, содержащую имя службы.
[in] hResource
Дескриптор ресурса для службы, полученной из OpenClusterResource.
[in] pfnLogEvent
Указатель на функцию точки входа LogEvent библиотеки DLL ресурса, управляющей службой.
[in] hResourceHandle
Дескриптор ресурса, необходимый для функции точки входа LogEvent . Используйте дескриптор, переданный библиотеке DLL в функции Открыть точку входа.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает ERROR_SUCCESS.
Если операция завершается сбоем, функция возвращает код системной ошибки.
Комментарии
ResUtilSetResourceServiceEnvironment вызывает ResUtilGetEnvironmentWithNetName и сохраняет результирующий блок среды в записи реестра для службы. Дополнительные сведения о влиянии блока среды см. в разделе ResUtilGetEnvironmentWithNetName.
Если библиотека DLL ресурса управляет службой, создайте рабочий поток и используйте ResUtilSetResourceServiceStartParameters и ResUtilSetResourceServiceEnvironment при переводе службы в сеть.
Не вызывайте ResUtilSetResourceServiceEnvironment из любой функции точки входа DLL ресурсов. ResUtilSetResourceServiceEnvironment можно безопасно вызывать из рабочего потока. Дополнительные сведения см. в разделе Вызовы функций, которые следует избегать в библиотеках DLL ресурсов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter |
| Целевая платформа | Windows |
| Header | resapi.h |
| Библиотека | ResUtils.lib |
| DLL | ResUtils.dll |