[Win32] SCManager 服務控制管理器API（2）

阿新 • • 發佈：2019-01-21

在上一篇博文“[Win32] SCManager 服務控制管理器API（1）”中（地址：http://blog.csdn.net/zuishikonghuan/article/details/47803033），講到了開啟服務控制管理器、建立服務、開啟服務、刪除服務、獲取服務狀態、啟動服務、傳送控制碼，這一篇繼續。

9。EnumServicesStatus 列舉服務

BOOL WINAPI EnumServicesStatus(
  _In_        SC_HANDLE             hSCManager,
  _In_        DWORD                 dwServiceType,
  _In_        DWORD                 dwServiceState,
  _Out_opt_   LPENUM_SERVICE_STATUS lpServices,
  _In_        DWORD                 cbBufSize,
  _Out_       LPDWORD               pcbBytesNeeded,
  _Out_       LPDWORD               lpServicesReturned,
  _Inout_opt_ LPDWORD               lpResumeHandle
);

hSCManager：服務控制管理器控制代碼。此控制代碼是OpenSCManager函式返回的，並且必須具有 SC_MANAGER_ENUMERATE_SERVICE 訪問許可權。

dwServiceType：要列舉的服務型別。

SERVICE_DRIVER：SERVICE_KERNEL_DRIVER 和 SERVICE_FILE_SYSTEM_DRIVER。

SERVICE_FILE_SYSTEM_DRIVER：檔案系統驅動程式服務。

SERVICE_KERNEL_DRIVER：驅動程式服務。

SERVICE_WIN32：SERVICE_WIN32_OWN_PROCESS 和 SERVICE_WIN32_SHARE_PROCESS。

SERVICE_WIN32_OWN_PROCESS：在他們自己的程序中執行的服務。

SERVICE_WIN32_SHARE_PROCESS：與一個或多個其他服務共享一個程序的服務。

一般為SERVICE_WIN32

dwServiceState：服務要列舉的狀態。此引數可以是下列值之一：

SERVICE_ACTIVE：列舉是處於以下狀態的服務: SERVICE_START_PENDING、 SERVICE_STOP_PENDING、 SERVICE_RUNNING、SERVICE_CONTINUE_PENDING、 SERVICE_PAUSE_PENDING 和 SERVICE_PAUSED。

SERVICE_INACTIVE：列舉服務處於 SERVICE_STOPPED 狀態。

SERVICE_STATE_ALL：SERVICE_ACTIVE 和 SERVICE_INACTIVE。

lpServices：指向包含陣列的 ENUM_SERVICE_STATUS 結構，它接收名稱服務資料庫中的每個服務的狀態資訊的緩衝區的指標。緩衝區必須足夠大以容納結構，再加上他們的成員所指向的字串。此陣列的最大大小為 256 K 位元組。若要確定所需的大小，請為此引數與 cbBufSize 引數置 0。該函式將失敗，時出錯將返回 ERROR_INSUFFICIENT_BUFFER。PcbBytesNeeded 引數將收到所需的大小。

ENUM_SERVICE_STATUS 結構：

typedef struct _ENUM_SERVICE_STATUS {
  LPTSTR         lpServiceName;
  LPTSTR         lpDisplayName;
  SERVICE_STATUS ServiceStatus;
} ENUM_SERVICE_STATUS, *LPENUM_SERVICE_STATUS;
lpServiceName：服務名稱

lpDisplayName：顯示名稱

ServiceStatus：服務狀態

cbBufSize：以位元組為單位所指向的緩衝區的大小

pcbBytesNeeded：如果緩衝區太小，指向接收的需要返回剩餘的服務條目的位元組數的變數的指標。

lpServicesReturned：指向一個變數來接收服務項數返回的指標。

lpResumeHandle：一個指標指向的變數的輸入，指定列舉的起始點。你必須第一次呼叫此函式設定此值為零。

返回值：如果此函式成功，返回值不為零。如果函式失敗，返回值為零。

10。QueryServiceConfig 獲取服務配置引數

BOOL WINAPI QueryServiceConfig(
  _In_      SC_HANDLE              hService,
  _Out_opt_ LPQUERY_SERVICE_CONFIG lpServiceConfig,
  _In_      DWORD                  cbBufSize,
  _Out_     LPDWORD                pcbBytesNeeded
);

hService：務的控制代碼。此控制代碼是OpenService 或 CreateService函式返回的，並且它必須具有 SERVICE_QUERY_CONFIG 訪問許可權。

lpServiceConfig：指向接收服務配置資訊的緩衝區的指標。資料的格式是一個 QUERY_SERVICE_CONFIG 結構。

QUERY_SERVICE_CONFIG結構：

typedef struct _QUERY_SERVICE_CONFIG {
  DWORD  dwServiceType;
  DWORD  dwStartType;
  DWORD  dwErrorControl;
  LPTSTR lpBinaryPathName;
  LPTSTR lpLoadOrderGroup;
  DWORD  dwTagId;
  LPTSTR lpDependencies;
  LPTSTR lpServiceStartName;
  LPTSTR lpDisplayName;
} QUERY_SERVICE_CONFIG, *LPQUERY_SERVICE_CONFIG;
dwServiceType：見上一篇中對”Createservice“的介紹。（傳送門）

dwStartType：見上一篇中對”Createservice“的介紹。（傳送門）

dwErrorControl：見上一篇中對”Createservice“的介紹。（傳送門）

lpBinaryPathName：見上一篇中對”Createservice“的介紹。（傳送門）

lpLoadOrderGroup：見上一篇中對”Createservice“的介紹。（傳送門）

dwTagId：見上一篇中對”Createservice“的介紹。（傳送門）

lpDependencies：見上一篇中對”Createservice“的介紹。（傳送門）

lpServiceStartName：如果服務型別為 SERVICE_WIN32_OWN_PROCESS 或 SERVICE_WIN32_SHARE_PROCESS，此成員是帳戶的服務程序將登入作為執行時的名稱。此名稱可以是Domain\UserName。如果該帳戶屬於內建域，名稱可以是.\UserName。如果程序執行在本地系統帳戶下，名稱也可以"LocalSystem"。
如果服務型別為 SERVICE_KERNEL_DRIVER 或 SERVICE_FILE_SYSTEM_DRIVER，此成員是驅動程式物件名稱 (即，\FileSystem\Rdr 或 \Driver\Xns)，輸入和輸出 (I/O) 系統使用載入裝置驅動程式。如果此成員為 NULL，驅動程式是由 I/O 系統，根據服務名稱建立的預設物件名稱執行。

lpDisplayName：服務描述。能超過型別為 REG_SZ 登錄檔值的大小。也可以指定為這樣：@[path\]dllname,-strID。請參見MSDN文件的RegLoadMUIString

cbBufSize：以位元組為單位的緩衝區的大小

pcbBytesNeeded：如果緩衝區太小，指向接收的需要返回剩餘的服務條目的位元組數的變數的指標。

返回值：如果此函式成功，返回值不為零。如果函式失敗，返回值為零。

11。QueryServiceConfig2 獲取服務配置可選引數

BOOL WINAPI QueryServiceConfig2(
  _In_      SC_HANDLE hService,
  _In_      DWORD     dwInfoLevel,
  _Out_opt_ LPBYTE    lpBuffer,
  _In_      DWORD     cbBufSize,
  _Out_     LPDWORD   pcbBytesNeeded
);

hService：服務控制代碼。此控制代碼是 OpenService 或 CreateService 函式返回的，並且它必須具有 SERVICE_QUERY_CONFIG 訪問許可權。

dwInfoLevel：要查詢的配置資訊。此引數可以是下列值之一：

SERVICE_CONFIG_DELAYED_AUTO_START_INFO：LpInfo 引數是指向 SERVICE_DELAYED_AUTO_START_INFO 結構的指標。Windows Server 2003 和 Windows XP: 不支援此值。

SERVICE_CONFIG_DESCRIPTION：緩衝區引數是指向 SERVICE_DESCRIPTION 結構的指標。

SERVICE_CONFIG_FAILURE_ACTIONS：緩衝區引數是指向 SERVICE_FAILURE_ACTIONS 結構的指標。

SERVICE_CONFIG_FAILURE_ACTIONS_FLAG：LpInfo 引數是指向 SERVICE_FAILURE_ACTIONS_FLAG 結構的指標。Windows Server 2003 和 Windows XP: 不支援此值。

SERVICE_CONFIG_PREFERRED_NODE：LpInfo 引數是指向 SERVICE_PREFERRED_NODE_INFO 結構的指標。Windows Server 2008、 Windows Vista、 Windows Server 2003 和 Windows XP: 不支援此值。

SERVICE_CONFIG_PRESHUTDOWN_INFO：LpInfo 引數是指向 SERVICE_PRESHUTDOWN_INFO 結構的指標。Windows Server 2003 和 Windows XP: 不支援此值。

SERVICE_CONFIG_REQUIRED_PRIVILEGES_INFO：LpInfo 引數是指向 SERVICE_REQUIRED_PRIVILEGES_INFO 結構的指標。Windows Server 2003 和 Windows XP: 不支援此值。

SERVICE_CONFIG_SERVICE_SID_INFO：LpInfo 引數是指向 SERVICE_SID_INFO 結構的指標。Windows Server 2003 和 Windows XP: 不支援此值。

SERVICE_CONFIG_TRIGGER_INFO：LpInfo 引數是指向 SERVICE_TRIGGER_INFO 結構的指標。Windows Server 2008、 Windows Vista、 Windows Server 2003 和 Windows XP: 不支援此值。

SERVICE_CONFIG_LAUNCH_PROTECTED：LpInfo 引數是一個 SERVICE_LAUNCH_PROTECTED_INFO 結構的指標。此值從 Windows 8.1 開始支援。

lpBuffer：指向接收服務配置資訊的緩衝區的指標。此資料的格式取決於 dwInfoLevel 引數的值。
此陣列的最大大小為 8k 位元組。若要確定所需的大小，請將此引數與 cbBufSize 引數設定為 0。該函式將失敗GetLastError返回 ERROR_INSUFFICIENT_BUFFER。PcbBytesNeeded 引數接收所需的大小。

SERVICE_DESCRIPTION 結構：

typedef struct _SERVICE_DESCRIPTION {
  LPTSTR lpDescription;
} SERVICE_DESCRIPTION, *LPSERVICE_DESCRIPTION;
lpDescription：服務描述。能超過型別為 REG_SZ 登錄檔值的大小。也可以指定為這樣：@[path\]dllname,-strID。請參見MSDN文件的RegLoadMUIString

SERVICE_FAILURE_ACTIONS 結構：

typedef struct _SERVICE_FAILURE_ACTIONS {
  DWORD     dwResetPeriod;
  LPTSTR    lpRebootMsg;
  LPTSTR    lpCommand;
  DWORD     cActions;
  SC_ACTION *lpsaActions;
} SERVICE_FAILURE_ACTIONS, *LPSERVICE_FAILURE_ACTIONS;
dwResetPeriod：以秒為單位，表示服務失敗計數在沒有錯誤下重置的時間，INFINITE表示永遠不會被重置 lpRebootMsg：要重新啟動 SC_ACTION_REBOOT 服務控制器動作響應之前廣播到伺服器的使用者的訊息。對於修改配置，如果此值為 NULL，重新啟動訊息是不變的。如果值為空字串 ("")，重新啟動訊息將被刪除並沒有訊息被廣播。 lpCommand：響應 SC_ACTION_RUN_COMMAND 時執行程序的命令列。這一過程在相同的服務帳戶下執行。對於修改配置，如果此值為 NULL，該命令是不變的。如果值為空字串 ("")，該命令刪除並且服務失敗時不執行任何程式。 cActions：LpsaActions 陣列中的元素數。對於修改配置，如果此值為 0，但 lpsaActions 不是 NULL，刪除重置期間和失敗操作的陣列。 lpsaActions：指向一個 SC_ACTION 結構陣列的指標。對於修改配置，如果此值為 NULL，則忽略，cActions 和 dwResetPeriod 的成員。 SC_ACTION 結構：
typedef struct _SC_ACTION {
  SC_ACTION_TYPE Type;
  DWORD          Delay;
} SC_ACTION, *LPSC_ACTION;
Type：要執行的操作。此成員可以是下列之一：
SC_ACTION_NONE：沒有行動。

SC_ACTION_REBOOT：重新啟動計算機。

SC_ACTION_RESTART：重新啟動該服務。

SC_ACTION_RUN_COMMAND：執行一個命令。
Delay：在執行指定的操作，以毫秒為單位之前等待的時間。
備註：服務啟動失敗時，系統啟動的次數進行計數。經過 dwResetPeriod 秒時，計數重置為 0。當服務失敗第 n 次時，服務控制器執行 lpsaActions 陣列中的元素 [N-1] 中指定的操作。如果 N 大於 cActions，服務控制器重複上次運算元組中。

cbBufSize：以位元組為單位的緩衝區的大小

pcbBytesNeeded：如果緩衝區太小，指向接收的需要返回剩餘的服務條目的位元組數的變數的指標。

返回值：如果此函式成功，返回值不為零。如果函式失敗，返回值為零。

12。ChangeServiceConfig 修改服務配置引數

BOOL WINAPI ChangeServiceConfig(
  _In_      SC_HANDLE hService,
  _In_      DWORD     dwServiceType,
  _In_      DWORD     dwStartType,
  _In_      DWORD     dwErrorControl,
  _In_opt_  LPCTSTR   lpBinaryPathName,
  _In_opt_  LPCTSTR   lpLoadOrderGroup,
  _Out_opt_ LPDWORD   lpdwTagId,
  _In_opt_  LPCTSTR   lpDependencies,
  _In_opt_  LPCTSTR   lpServiceStartName,
  _In_opt_  LPCTSTR   lpPassword,
  _In_opt_  LPCTSTR   lpDisplayName
);

hService：服務控制代碼。此控制代碼是OpenService 或 CreateService函式返回的，並且必須具有 SERVICE_CHANGE_CONFIG 訪問許可權。

從 dwServiceType 到 lpServiceStartName ：參見上面的QUERY_SERVICE_CONFIG結構（快速跳轉）

lpPassword：LpServiceStartName 引數所指定的帳戶名稱的密碼。如果您不更改現有的密碼，請指定 NULL。如果該帳戶沒有密碼，或在本地、網路服務或本地系統帳戶執行該服務，請指定空字串。

lpDisplayName：服務描述。能超過型別為 REG_SZ 登錄檔值的大小。也可以指定為這樣：@[path\]dllname,-strID。請參見MSDN文件的RegLoadMUIString

返回值：如果此函式成功，返回值不為零。如果函式失敗，返回值為零。

13。ChangeServiceConfig2 修改服務配置可選引數

BOOL WINAPI ChangeServiceConfig2(
  _In_     SC_HANDLE hService,
  _In_     DWORD     dwInfoLevel,
  _In_opt_ LPVOID    lpInfo
);

hService：服務的控制代碼。此控制代碼是OpenService 或 CreateService函式返回的，並且必須具有 SERVICE_CHANGE_CONFIG 訪問許可權。

dwInfoLevel：見上面QueryServiceConfig2的相關內容（快速跳轉）

lpInfo：見上面QueryServiceConfig2的相關內容（快速跳轉）

返回值：如果此函式成功，返回值不為零。如果函式失敗，返回值為零。

示例原始碼： 引數說明和程式碼註釋就不寫了，如果看過上文理解下面的很輕鬆。 ①列舉服務

BOOL WINAPI ListWin32Service(){
	SC_HANDLE hSCManager = OpenSCManager(NULL, NULL, SC_MANAGER_ENUMERATE_SERVICE);
	if (hSCManager != NULL){
		DWORD BytesNeeded;
		DWORD count;
		EnumServicesStatus(hSCManager, SERVICE_WIN32, SERVICE_STATE_ALL, NULL, 0, &BytesNeeded, &count, 0);
		char* buffer = new char[BytesNeeded];
		RtlZeroMemory(buffer, BytesNeeded);
		ENUM_SERVICE_STATUS* Services = (ENUM_SERVICE_STATUS*)buffer;
		if (EnumServicesStatus(hSCManager, SERVICE_WIN32, SERVICE_STATE_ALL, Services, BytesNeeded, &BytesNeeded, &count, 0)){
			for (int i = 0; i < count; i++) _putts(Services[i].lpServiceName);
			delete[] buffer;
			return TRUE;
		}
		delete[] buffer;
		CloseServiceHandle(hSCManager);
		return FALSE;
	}
	else return FALSE;
}

②修改服務描述

BOOL WINAPI SetServiceDescription(LPCTSTR ServiceName, LPTSTR Description){
	SC_HANDLE hSCManager = OpenSCManager(NULL, NULL, SC_MANAGER_CONNECT);
	if (hSCManager != NULL){
		SC_HANDLE hService = OpenService(hSCManager, ServiceName, SERVICE_CHANGE_CONFIG);
		if (hService != NULL){
			SERVICE_DESCRIPTION desc;
			desc.lpDescription = Description;
			if (ChangeServiceConfig2(hService, SERVICE_CONFIG_DESCRIPTION, &desc))
			{
				CloseServiceHandle(hService);
				CloseServiceHandle(hSCManager);
				return TRUE;
			}
			CloseServiceHandle(hService);
			CloseServiceHandle(hSCManager);
			return FALSE;
		}
		CloseServiceHandle(hSCManager);
		return FALSE;
	}
	else return FALSE;
}

③讓服務啟動失敗後總是恢復

BOOL WINAPI LetServiceAlwaysReboot(LPCTSTR ServiceName){
	SC_HANDLE hSCManager = OpenSCManager(NULL, NULL, SC_MANAGER_CONNECT);
	if (hSCManager != NULL){
		SC_HANDLE hService = OpenService(hSCManager, ServiceName, SC_MANAGER_ALL_ACCESS);//值得一提的是需要用SC_MANAGER_ALL_ACCESS
		if (hService != NULL){
			SERVICE_FAILURE_ACTIONS failact = { 0 };
			SC_ACTION act[3];
			act[0].Delay = act[1].Delay = act[2].Delay = 0;
			act[0].Type = act[1].Type = act[2].Type = SC_ACTION_RESTART;
			failact.cActions = 3;
			failact.lpsaActions = act;
			failact.dwResetPeriod = 0;
			if (ChangeServiceConfig2(hService, SERVICE_CONFIG_FAILURE_ACTIONS, &failact))
			{
				CloseServiceHandle(hService);
				CloseServiceHandle(hSCManager);
				return TRUE;
			}
			CloseServiceHandle(hService);
			CloseServiceHandle(hSCManager);
			return FALSE;
		}
		CloseServiceHandle(hSCManager);
		return FALSE;
	}
	else return FALSE;
}

[Win32] SCManager 服務控制管理器API（2）

[Win32] SCManager 服務控制管理器API（2）

DIM-00014：無法開啟windows nt服務控制管理器

不用寫Windows服務實現定時器功能（FluentScheduler ）

Qt入門佈局管理器layout（三）

npm模組管理器入門（轉載）

Spring Cloud：服務閘道器zuul（10）

Java虛擬機性能管理神器 - VisualVM（2）入門

（7）javascript的程序控制結構及語句------（2）循環控制語句、跳轉語句、對話框

splash3.2學習筆記——HTTP API（2）

zookeeper java api（2）

nova原始碼分析--API（2）

MSP430微控制器各種暫存器總結（2）——UCS

Android Wear計時器開發（2）

簡易智慧家居管理--魔鏡（2）：介面

Redis原始碼分析（三十五）--- redis.c服務端的實現分析（2）

SDL 與 FFMPEG 音樂播放器開發（2）——混播多個音訊

CODING 告訴你矽谷專案經理的專案管理之道（2）

【JVM】垃圾回收器總結（2）——七種垃圾回收器型別

Spring Cloud Zuul（API閘道器服務）（2）

持久化API（JPA）系列(四)管理器EntityManager--執行資料庫更新

[Win32] SCManager 服務控制管理器API（2）

相關推薦