SetupInstallFromInfSectionA 函式 （setupapi.h）

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

SetupInstallFromInfSection 函式會執行 INF 檔案 Install 區段中的所有指示詞。

如果修改登錄或檔案，則此函式的呼叫端必須具有寫入系統或目標目錄的許可權。

語法

WINSETUPAPI BOOL SetupInstallFromInfSectionA(
  HWND                Owner,
  HINF                InfHandle,
  PCSTR               SectionName,
  UINT                Flags,
  HKEY                RelativeKeyRoot,
  PCSTR               SourceRootPath,
  UINT                CopyFlags,
  PSP_FILE_CALLBACK_A MsgHandler,
  PVOID               Context,
  HDEVINFO            DeviceInfoSet,
  PSP_DEVINFO_DATA    DeviceInfoData
);

參數

Owner

視窗句柄的選擇性指標，指向擁有安裝期間產生之任何對話框的視窗，例如磁碟提示或檔案複製。 如果未指定 擁有者，這些對話框會變成最上層視窗。

InfHandle

處理包含要處理之區段的 INF 檔案。

SectionName

要處理的 INF 檔案中 安裝 區段的名稱。

Flags

控制要執行的動作。 旗標可以是下列值的組合。

SPINST_INIFILES

執行 INI 檔案作業（UpdateInis、UpdateIniFields 行中正在處理的安裝區段中）。

SPINST_REGISTRY

執行登錄作業 （AddReg、DelReg 行 安裝 區段中正在處理）。

SPINST_INI2REG

執行 INI 檔案到登錄作業 （Ini2Reg 行 安裝 區段正在處理）。

SPINST_LOGCONFIG

只有在安裝設備驅動器時，才會使用此旗標。

執行邏輯組態作業（處理 Install 區段中的 LogConf 行）。 只有在指定 DeviceInfoSet 和 DeviceInfoData 時 ，才會使用此旗標。

如需安裝設備驅動器、LogConf、DeviceInfoSet或 DeviceInfoData的詳細資訊，請參閱 DDK 程式設計人員指南。

SPINST_FILES

執行檔案作業（CopyFiles、DelFiles、RenFiles 行 安裝 區段中處理）。

SPINST_ALL

執行所有安裝作業。

SPINST_REGISTERCALLBACKAWARE

使用 RegisterDlls INF 指示詞在 Windows 2000 上自我註冊 DLL 時，SetupInstallFromInfSection 的呼叫者可能會在註冊或取消註冊時收到每個檔案上的通知。 若要將 SPFILENOTIFY_STARTREGISTRATION 或 SPFILENOTIFY_ENDREGISTRATION 通知傳送至回呼例程，請包含SPINST_REGISTERCALLBACKAWARE加上SPINST_REGSVR或SPINST_UNREGSVR。 呼叫端也必須設定 msgHandler 參數 。

SPINST_REGSVR

若要在註冊檔案時將通知傳送至回呼例程，請在 Flags中包含 SPINST_REGISTERCALLBACKAWARE 加上 SPINST_REGSVR。 呼叫端也必須指定 msgHandler 參數 。

SPINST_UNREGSVR

若要在取消註冊檔案時將通知傳送至回呼例程，請在 Flags中包含SPINST_REGISTERCALLBACKAWARE加上SPINST_UNREGSVR。 呼叫端也必須指定 msgHandler 參數 。

RelativeKeyRoot

如果 旗標 包含SPINST_REGISTRY或SPINST_INI2REG，則必須指定選擇性參數。 當 INF 檔案將 HKR 指定為機碼時，要當做根目錄使用的登錄機碼句柄。 請注意，如果呼叫 SetupInstallFromInfSection，則會使用選擇性 的 deviceInfoSet 和 DeviceInfoData 集來呼叫此參數。

SourceRootPath

檔案複本的來源根目錄。 例如 A：\ 或 \pegasus\win\install。 如果 旗標 包含SPINST_FILES，且 SourceRootPath 為 NULL，則系統會提供預設的根路徑。

CopyFlags

如果 旗標 包含SPINST_FILES，則必須指定選擇性參數。 指定當檔案排入佇列以供複製時，要傳遞至 SetupQueueCopySection 函式的旗標。 這些旗標可能是下列值的組合。

SP_COPY_DELETESOURCE

成功複製時，請刪除來源檔案。 如果刪除失敗，則不會通知呼叫端。

SP_COPY_REPLACEONLY

只有在這樣做會覆寫目的地路徑上的檔案時，才複製檔案。

SP_COPY_NEWER_OR_SAME

檢查所複製的每個檔案，以查看其版本資源是否表示其版本是否與目標上的現有複本相同或不是更新版本。

在版本檢查期間所使用的檔案版本資訊，是在 dwFileVersionMS 和 dwFileVersionLSVS_FIXEDFILEINFO 結構的成員中所指定，如版本函式所填入。 如果其中一個檔案沒有版本資源，或它們具有相同的版本資訊，則來源檔案會被視為較新。

如果原始程式檔在版本或更新版本中不相等，且已指定 CopyMsgHandler，呼叫端會收到通知，而且可能會取消複本。 如果未指定 CopyMsgHandler，則不會複製檔案。

SP_COPY_NEWER_ONLY

檢查要複製的每個檔案，以查看其版本資源是否表示它不是比目標上現有的複本還新。 如果來源檔案較新，但不等於現有目標的版本，則會複製該檔案。

SP_COPY_NOOVERWRITE

檢查目標檔案是否存在，如果是的話，請通知可能否決該複本的呼叫端。 如果未指定 copyMsgHandler ，則不會覆寫檔案。

SP_COPY_NODECOMP

請勿解壓縮檔案。 設定此旗標時，目標檔案不會提供來源名稱的未壓縮形式（如果適當的話）。 例如，將 f：/x86\cmd.ex_複製到 \install\temp 會導致目標檔案為 \install\temp\cmd.ex_。 如果未指定SP_COPY_NODECOMP旗標，則會解壓縮檔案，並將目標稱為 \install\temp\cmd.exe。 DestinationName的檔名部分，如果指定，則會移除並以來源檔案的檔名取代。 指定SP_COPY_NODECOMP時，無法檢查任何語言或版本資訊。

SP_COPY_LANGUAGEAWARE

檢查所複製的每個檔案，以查看其語言是否與目標上任何現有檔案的語言不同。 若是如此，並指定 CopyMsgHandler，呼叫端會收到通知，而且可能會取消複本。 如果未指定 CopyMsgHandler，則不會複製檔案。

SP_COPY_SOURCE_ABSOLUTE

SourceFile 是完整的來源路徑。 請勿在 INF 檔案的 SourceDisksNames 區段中查閱。

SP_COPY_SOURCEPATH_ABSOLUTE

SourcePathRoot 是來源檔案的完整路徑部分。 針對檔案所在的來源媒體，忽略 INF 檔案 SourceDisksNames 區段中指定的相對來源。 如果指定SP_COPY_SOURCE_ABSOLUTE，則會忽略此旗標。

SP_COPY_FORCE_IN_USE

如果目標存在，則行為就好像正在使用中，並在下一次系統重新啟動時將檔案排入佇列。

SP_COPY_IN_USE_NEEDS_REBOOT

如果在複製作業期間使用檔案，請通知使用者系統必須重新啟動。 只有在稍後 呼叫 setupPromptReboot 或 SetupScanFileQueue時，才會使用此旗標。

SP_COPY_NOSKIP

請勿提供使用者略過檔案的選項。

SP_COPY_FORCE_NOOVERWRITE

檢查目標檔案是否存在，如果存在，則不會覆寫檔案。 呼叫端未收到通知。

SP_COPY_FORCE_NEWER

檢查每個正在複製的檔案，以查看其版本資源（或非映像檔案的時間戳）是否表示它不比目標上的現有複本還新。 如果複製的檔案不是較新檔案，則不會複製檔案。 呼叫端未收到通知。

SP_COPY_WARNIFSKIP

如果用戶嘗試略過檔案，請警告他們略過檔案可能會影響安裝。 （用於系統關鍵檔案。）

MsgHandler

回呼例程的指標。 回呼例程的格式必須是 fileCallback 。 如需詳細資訊，請參閱 通知。

只有當 Flags 參數不包含SPINST_FILES、SPINST_REGISTERCALLBACKAWARE加SPINST_REGSVR或SPINST_UNREGSVR時，這個參數才為選擇性參數。

如果 旗標 包含SPINST_FILES，則必須設定 msgHandler 。 在此情況下，當使用 setupCommitFileQueue認可檔案佇列時，通知會傳送至回呼例程。

如果 旗標 包含SPINST_REGISTERCALLBACKAWARE加上SPINST_REGSVR或SPINST_UNREGSVR，則必須設定 msgHandler。 在此情況下，每次使用 Windows 2000 上的 RegisterDlls INF 指示詞註冊或取消註冊檔案時，就會將 SPFILENOTIFY_STARTREGISTRATION 或 SPFILENOTIFY_ENDREGISTRATION 傳送至回呼例程。

Context

當內部透過 setupCommitFileQueue認可這個例程所建置的檔案佇列時，要傳遞至回呼函式的值。 只有當 旗標 參數不包含SPINST_FILES時，Context 參數才為選擇性參數。 如果 旗標 包含SPINST_FILES，則必須指定此參數。

DeviceInfoSet

裝置資訊集句柄的選擇性指標。 如需裝置安裝程式安裝函式的詳細資訊，請參閱 DDK 程式設計人員指南。

DeviceInfoData

SP_DEVINFO_DATA 結構的指標的選擇性指標，該結構提供 deviceInfoSet 所指定集合中特定項目的內容。 如需裝置安裝程式安裝函式的詳細資訊，請參閱 DDK 程式設計人員指南。

傳回值

如果函式成功，則傳回值是非零值。

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

如果 UNC 目錄指定為檔案複製作業的目標目錄，您必須先確定該目錄存在，再呼叫 SetupInstallFromInfSection。 安裝程式函式不會檢查 是否存在，而且不會建立 UNC 目錄。 如果目標 UNC 目錄不存在，檔案安裝將會失敗。

此函式需要 Windows INF 檔案。 某些較舊的 INF 檔案格式可能不受支援。

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

要求

另請參閱

函式

概觀

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallServicesFromInfSection