SetupInstallServicesFromInfSectionA 函式 (setupapi.h)
[此函式可用於需求一節中所述的操作系統。 它在後續版本中可能會變更或無法使用。 安裝程式API不應再用於安裝應用程式。 請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備驅動器。]
SetupInstallServicesFromInfSection 函式會執行服務安裝和刪除作業,這些作業是在 INF 檔案之 Service 區段所列的服務安裝區段中所指定的。
需要此函式的呼叫端才能存取 服務控制管理員,以及修改服務的許可權。
語法
WINSETUPAPI BOOL SetupInstallServicesFromInfSectionA(
[in] HINF InfHandle,
[in] PCSTR SectionName,
[in] DWORD Flags
);
參數
[in] InfHandle
包含 服務 區段之 INF 檔案的句柄。
[in] SectionName
要處理的 [服務 ] 區段名稱。 您應該使用以 Null 結尾的字串。
[in] Flags
指定區段中每個服務的安裝控制件。
旗標 |
意義 |
- SPSVCINST_TAGTOFRONT
- 0x001
|
AddService 區段:將服務卷標移至其群組順序列表的前面。
|
- SPSVCINST_DELETEEVENTLOGENTRY
- 0x004
|
DelService 區段:刪除事件記錄檔專案。
|
- SPSVCINST_NOCLOBBER_DISPLAYNAME
- 0x008
|
AddService 區段:如果已有顯示名稱,請勿覆寫顯示名稱。
|
- SPSVCINST_NOCLOBBER_STARTTYPE
- 0x010
|
AddService 區段:如果服務已經存在,請勿覆寫啟動類型值。
|
- SPSVCINST_NOCLOBBER_ERRORCONTROL
- 0x020
|
AddService 區段:如果服務已經存在,請勿覆寫錯誤控制值。
|
- SPSVCINST_NOCLOBBER_LOADORDERGROUP
- 0x040
|
AddService 區段:如果載入順序群組已經存在,請勿覆寫載入順序群組。
|
- SPSVCINST_NOCLOBBER_DEPENDENCIES
- 0x080
|
AddService 區段:如果相依性清單已經存在,請勿覆寫它。
|
- SPSVCINST_NOCLOBBER_DESCRIPTION
- 0x100
|
AddService 區段:將此服務標示為所安裝裝置的函式驅動程式。
|
- SPSVCINST_STOPSERVICE
- 0x200
|
DelService 區段:刪除服務之前,請先停止專案中指定的相關聯服務。
|
- SPSVCINST_CLOBBER_SECURITY
- 0x400
|
AddService 區段:如果服務已存在於系統中,則會覆寫服務的安全性設定。
注意 從 Windows Server 2003 和 Windows XP 開始提供。
|
- SPSVCINST_STARTSERVICE
- 0x800
|
AddService 區段:安裝服務之後啟動服務。 此旗標無法用來啟動實作裝置 隨插即用 (PnP) 函式驅動程式或篩選驅動程式的服務。 否則,此旗標可用來啟動服務控制管理員所管理的使用者模式或內核模式服務, (SCM.) 注意 從 Windows Server 2008 和 Windows Vista 開始提供。
|
- SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES
- 0x1000
|
AddService 區段:如果服務已存在於系統中,請勿覆寫指定服務的必要許可權。
注意 從 Windows Server 2008 R2 和 Windows 7 開始提供。
|
傳回值
如果函式成功,則傳回非零的值。 如果需要重新啟動系統,此函式會以ERROR_SUCCESS_REBOOT_REQUIRED呼叫 SetLastError 。
如果函式失敗,傳回值為 0 (零) 。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
注意
setupapi.h 標頭會根據 UNICODE 預處理器常數的定義,將 SetupInstallServicesFromInfSection 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 |
值 |
最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
目標平台 |
Windows |
標頭 |
setupapi.h |
程式庫 |
Setupapi.lib |
Dll |
Setupapi.dll |
API 集合 |
ext-ms-win-setupapi-classinstallers-l1-1-2 (於 Windows 10 10.0.14393 版) |
請參閱
函式
概觀
SetupInstallFilesFromInfSection
SetupInstallFromInfSection
SetupInstallServicesFromInfSectionEx