QUERY_SERVICE_CONFIGA 結構 (winsvc.h)

發行項
03/13/2024

包含已安裝服務的組態資訊。 QueryServiceConfig 函式會使用它。

語法

typedef struct _QUERY_SERVICE_CONFIGA {
  DWORD dwServiceType;
  DWORD dwStartType;
  DWORD dwErrorControl;
  LPSTR lpBinaryPathName;
  LPSTR lpLoadOrderGroup;
  DWORD dwTagId;
  LPSTR lpDependencies;
  LPSTR lpServiceStartName;
  LPSTR lpDisplayName;
} QUERY_SERVICE_CONFIGA, *LPQUERY_SERVICE_CONFIGA;

成員

dwServiceType

服務的型別。這個成員可以是下列其中一個值。

值	意義
SERVICE_FILE_SYSTEM_DRIVER 0x00000002	檔系統驅動程式服務。
SERVICE_KERNEL_DRIVER 0x00000001	驅動程式服務。
SERVICE_WIN32_OWN_PROCESS 0x00000010	在自己的進程中執行的服務。
SERVICE_WIN32_SHARE_PROCESS 0x00000020	與其他服務共用進程的服務。

如果此值 是SERVICE_WIN32_OWN_PROCESS 或 SERVICE_WIN32_SHARE_PROCESS，而且服務是在 LocalSystem帳戶的內容中執行，則也可能指定下列類型。

值	意義
SERVICE_INTERACTIVE_PROCESS 0x00000100	服務可以與桌面互動。如需詳細資訊，請參閱互動式服務。

dwStartType

啟動服務的時機。這個成員可以是下列其中一個值。

值	意義
SERVICE_AUTO_START 0x00000002	服務控制管理員在系統啟動期間自動啟動。
SERVICE_BOOT_START 0x00000000	系統載入器啟動的裝置驅動程式。這個值只適用於驅動程式服務。
SERVICE_DEMAND_START 0x00000003	當行程呼叫 StartService 函式時，由服務控制管理員啟動的服務。
SERVICE_DISABLED 0x00000004	無法啟動的服務。嘗試啟動服務會導致錯誤碼 ERROR_SERVICE_DISABLED。
SERVICE_SYSTEM_START 0x00000001	IoInitSystem 函式啟動的裝置驅動程式。這個值只適用於驅動程式服務。

dwErrorControl

如果此服務無法啟動，則為錯誤的嚴重性和所採取的動作。這個成員可以是下列其中一個值。

值	意義
SERVICE_ERROR_CRITICAL 0x00000003	如果可能，啟動程式會在事件記錄檔中記錄錯誤。如果啟動最後一個已知良好的組態，啟動作業就會失敗。否則，系統會以最後一個已知的良好組態重新啟動。
SERVICE_ERROR_IGNORE 0x00000000	啟動程式會忽略錯誤並繼續啟動作業。
SERVICE_ERROR_NORMAL 0x00000001	啟動程式會在事件記錄檔中記錄錯誤，並繼續啟動作業。
SERVICE_ERROR_SEVERE 0x00000002	啟動程式會在事件記錄檔中記錄錯誤。如果啟動最後一個已知良好的組態，啟動作業會繼續。否則，系統會使用最後一個已知良好的組態重新啟動。

lpBinaryPathName

服務二進位檔的完整路徑。

路徑也可以包含自動啟動服務的自變數。這些自變數會傳遞至服務進入點， (通常是主要函式) 。

lpLoadOrderGroup

此服務所屬的負載排序群組名稱。如果成員為 NULL 或空字串，則服務不屬於載入排序群組。

啟動程式會使用負載排序群組，根據其他群組的指定順序載入服務群組。載入排序群組的清單包含在下列登入值中：

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\ServiceGroupOrder

dwTagId

lpLoadOrderGroup 參數所指定群組中此服務的唯一標記值。值為零表示服務尚未指派標記。您可以在登入指定位於下列位置的標籤順序向量，以載入訂單群組內使用標記來排序服務啟動：

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList

標記只會針對具有SERVICE_BOOT_START或SERVICE_SYSTEM_START啟動類型的SERVICE_KERNEL_DRIVER和SERVICE_FILE_SYSTEM_DRIVER類型服務進行評估。

lpDependencies

服務之 Null 分隔名稱陣列的指標，或載入必須在此服務之前啟動的排序群組。陣列會以 Null 結尾加倍。如果指標為 NULL ，或指向空字串，則服務沒有相依性。如果指定組名，則必須以 WinSvc.h) 字元中定義的 SC_GROUP_IDENTIFIER (開頭，才能區分它與服務名稱，因為服務和服務群組會共用相同的名稱空間。相依於服務表示，只有在相依的服務正在執行時，才能執行此服務。群組的相依性表示，如果嘗試啟動群組的所有成員之後，至少有一個群組成員正在執行，則此服務可以執行。

lpServiceStartName

如果服務類型 SERVICE_WIN32_OWN_PROCESS 或 SERVICE_WIN32_SHARE_PROCESS，此成員就是服務進程在執行時將登入的帳戶名稱。此名稱的格式可以是 Domain\UserName。如果帳戶屬於內建網域，則名稱的格式可以是 .\UserName。如果行程是在 LocalSystem 帳戶下執行，則名稱也可以是 “LocalSystem”。

如果服務類型 是SERVICE_KERNEL_DRIVER 或 SERVICE_FILE_SYSTEM_DRIVER，這個成員就是驅動程式物件名稱 (，也就是 \FileSystem\Rdr 或 \Driver\Xns) 輸入與輸出 (I/O) 系統用來載入設備驅動器。如果此成員為 NULL，則會根據服務名稱，以 I/O 系統所建立的預設物件名稱執行驅動程式。

lpDisplayName

服務控制程式用來識別服務的顯示名稱。這個字串的最大長度為 256 個字元。名稱會在服務控制管理員中保留大小寫。顯示名稱比較一律不區分大小寫。

這個參數可以使用下列格式來指定本地化字串：

@[Path]DLLName，-StrID

標識元 為 StrID 的字串會從 DLLName 載入; Path 是選擇性的。如需詳細資訊，請參閱 RegLoadMUIString。

Windows Server 2003 和 Windows XP： 在 Windows Vista 之前，不支援當地語系化字串。

備註

當呼叫 CreateService 函式建立服務時，一開始會指定服務的組態資訊。您可以藉由呼叫 ChangeServiceConfig 函式來修改資訊。

範例

如需範例，請參閱查詢服務的組態。

注意

winsvc.h 標頭會將QUERY_SERVICE_CONFIG定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	winsvc.h (包括 Windows.h)

另請參閱

共用方式為

QUERY_SERVICE_CONFIGA 結構 (winsvc.h)

語法

成員

備註

範例

規格需求

另請參閱

意見反應

其他資源