共用方式為

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