共用方式為

SetupInstallServicesFromInfSectionA 函式 （setupapi.h）

  • 發行項

[此函式可用於需求一節所指出的作業系統。 後續版本可能會變更或無法使用。 安裝程式API 不應該再用於安裝應用程式。 請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備驅動器。]

SetupInstallServicesFromInfSection 函式會執行 INF 檔案之 Service 區段中所指定之 Service Install 區段中所指定的服務安裝和刪除作業。

需要此函式的呼叫者才能存取 Service Control Manager，以及修改服務的許可權。

語法

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionA(
  [in] HINF  InfHandle,
  [in] PCSTR SectionName,
  [in] DWORD Flags
);

參數

[in] InfHandle

INF 檔案的句柄，其中包含 Service 區段。

[in] SectionName

要處理的 Service 區段名稱。 您應該使用以 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 區段：安裝服務之後啟動服務。 此旗標無法用來啟動實作隨插即用功能驅動程式或裝置篩選驅動程序的服務。 否則，這個旗標可以用來啟動服務控制管理員所管理的使用者模式或內核模式服務。。
從 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 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

SetupInstallServicesFromInfSection 會將診斷資訊記錄到 SetupAPI 應用程式安裝文字記錄檔。 根據預設，此記錄檔通常會關閉。 您可以修改 一般記錄層級， SetupAPI LogLevel 值的一部分來啟用，如 設定 SetupAPI 記錄層級中所述。 基於效能考慮，您應該只在針對問題進行疑難解答時啟用此記錄檔。 啟用記錄檔時，您可以在 %windir%\inf\setupapi.app.log找到它。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 setupapi.h
連結庫 Setupapi.lib
DLL Setupapi.dll
API 集 ext-ms-win-setupapi-classinstallers-l1-1-2 （在 Windows 10 版本 10.0.14393 中引進）

另請參閱

函式

概觀

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSectionEx