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

另請參閱

SetupDiCallClassInstaller

SetupDiInstallClassEx