SetupDiInstallClassA 函式 (setupapi.h)
SetupDiInstallClass 函式會安裝指定 INF 檔案的 ClassInstall32 區段。
語法
WINSETUPAPI BOOL SetupDiInstallClassA(
[in, optional] HWND hwndParent,
[in] PCSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue
);
參數
[in, optional] hwndParent
用於安裝這個類別之任何使用者介面之父視窗的句柄。 此參數是選擇性的,可以是 NULL。
[in] InfFileName
NULL 終止字串的指標,其中包含包含 INF ClassInstall32 區段的 INF 檔名。
[in] Flags
這些旗標會控制安裝程式。 可以是下列各項的組合:
DI_NOVCP
如果提供 FileQueue ,請設定此旗標。 DI_NOVCP指示 setupInstallFromInfSection 函式 (Microsoft Windows SDK 檔中所述,) 不要建立自己的佇列,而是改用呼叫端提供的佇列。 如果已設定此旗標,則不會只將檔案複製到佇列中。
DI_NOBROWSE
如果複製作業找不到指定的檔案,請將此旗標設定為停用流覽。 如果呼叫端提供檔案佇列,則會忽略此旗標。
DI_FORCECOPY
將此旗標設定為一律複製檔案,即使檔案已存在於用戶的計算機上也一樣。 如果呼叫端提供檔案佇列,則會忽略此旗標。
DI_QUIETINSTALL
除非絕對必要,否則請將此旗標設定為隱藏使用者介面。 例如,不要顯示進度對話方塊。 如果呼叫端提供檔案佇列,則會忽略此旗標。
[in, optional] FileQueue
如果已設定DI_NOVCP旗標,此參數會提供檔案作業應排入佇列但未認可的檔案佇列句柄。
傳回值
如果函式成功,函式會傳回 TRUE 。 否則,它會傳回 FALSE ,而且可以透過呼叫 GetLastError 來擷取記錄的錯誤。
備註
此函式的呼叫端必須是 Administrators 群組的成員。
當此函式安裝新裝置類別的裝置時,類別安裝程式會呼叫此函式。
若要安裝介面類別或裝置類別,請使用 SetupDiInstallClassEx。
注意
setupapi.h 標頭會將 SetupDiInstallClass 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
目標平台 | 桌面 |
標頭 | setupapi.h (包括 Setupapi.h) |
程式庫 | Setupapi.lib |