ResUtilSetResourceServiceStartParametersEx 函式 (resapi.h)
調整指定 服務的 啟動參數,使其正常運作為叢集 資源。 它必須從 資源 DLL 呼叫。 PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS_EX類型會定義此函式的指標。
語法
DWORD ResUtilSetResourceServiceStartParametersEx(
[in] LPCWSTR pszServiceName,
[in] SC_HANDLE schSCMHandle,
[in, out] LPSC_HANDLE phService,
[in] DWORD dwDesiredAccess,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
參數
[in] pszServiceName
指定服務名稱之 Null 終止 Unicode 字串的指標。
[in] schSCMHandle
服務控制管理員 (SCM) 或 NULL 的句柄。 如果 為 NULL,函式會嘗試開啟 SCM 的句柄。
[in, out] phService
在輸入時, NULL 服務句柄。 輸出時,如果呼叫成功,則處理指定的服務;否則 為 NULL。
[in] dwDesiredAccess
要求的存取許可權。 這可能是 GENERIC_READ (0x80000000) 、 GENERIC_ALL (0x10000000) 或 MAXIMUM_ALLOWED (0x02000000) 的任何組合。 如果此值為零 (0) ,可能會傳回未定義的錯誤。 使用 GENERIC_ALL 與呼叫 ResUtilSetResourceServiceStartParameters 相同。
[in] pfnLogEvent
管理服務之資源 DLL 之 LogEvent 進入點函式的指標。
[in] hResourceHandle
LogEvent 進入點函式所需的資源句柄。 使用傳遞至 Open 進入點函式中 DLL 的句柄。
傳回值
如果作業成功,函式會傳回 ERROR_SUCCESS。
如果作業失敗,函式會傳回 系統錯誤碼。
備註
ResUtilSetResourceServiceStartParametersEx 會確認服務未停用、將服務組態變更為手動啟動,並防止服務重新啟動以回應失敗。 這可讓 叢集 和資源 DLL 控制服務。
如果您的資源 DLL 管理服務,請先使用 ResUtilSetResourceServiceStartParametersEx 和 ResUtilSetResourceServiceEnvironment ,再讓服務上線。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2012 |
目標平台 | Windows |
標頭 | resapi.h |
程式庫 | ResUtils.lib |
Dll | ResUtils.dll |