Функция ResUtilTerminateServiceProcessFromResDll (resapi.h)
Пытается завершить процесс службы, управляемой в качестве ресурса кластера с помощью библиотеки DLL ресурса. Тип PRESUTIL_TERMINATE_SERVICE_PROCESS_FROM_RES_DLL определяет указатель на эту функцию.
Синтаксис
DWORD ResUtilTerminateServiceProcessFromResDll(
[in] DWORD dwServicePid,
[in] BOOL bOffline,
[out, optional] PDWORD pdwResourceState,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
Параметры
[in] dwServicePid
Идентификатор процесса завершаемого процесса службы.
[in] bOffline
Указывает, находится ли ресурс в автономном режиме или завершается. Задайте значение TRUE , если вызов вызывается из автономной точки входа или из рабочего потока, созданного для вывода ресурса в автономный режим. В противном случае укажите ЗНАЧЕНИЕ FALSE , и функция будет предполагать, что ресурс завершается.
[out, optional] pdwResourceState
Необязательный указатель на DWORD , который возвращает результирующее состояние ресурса, которое будет иметь значение ClusterResourceFailed или ClusterResourceOffline (полный список состояний ресурсов см. в разделе GetClusterResourceState). Если эти сведения не нужны, передайте значение NULL .
[in] pfnLogEvent
Указатель на функцию LogEvent , используемую библиотекой DLL ресурса. Этот указатель передается в библиотеку DLL ресурса в точке входа запуска .
[in] hResourceHandle
Дескриптор монитора ресурсов для ресурса. Этот дескриптор передается в библиотеку DLL ресурса в точке входа Open и должен быть сохранен как часть данных экземпляра ресурса.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает ERROR_SUCCESS.
Если операция завершается сбоем, функция возвращает код системной ошибки.
Обратите внимание, что ResUtilTerminateServiceProcessFromResDll использует pfnLogEvent и hResourceHandle для записи в журнал событий библиотеки DLL ресурса, что может помочь в устранении неполадок.
Комментарии
Следует вызывать ResUtilTerminateServiceProcessFromResDll только при завершении работы ресурса или при переводе ресурса в автономный режим.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Ни одна версия не поддерживается |
Минимальная версия сервера | Windows Server 2008 Datacenter, Windows Server 2008 Корпоративная |
Целевая платформа | Windows |
Header | resapi.h |
Библиотека | ResUtils.lib |
DLL | ResUtils.dll |