Поделиться через


Функция 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

См. также раздел

Функции служебной программы службы