共用方式為

SetupOpenAppendInfFileA 函式 （setupapi.h）

  • 發行項

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

SetupOpenAppendInfFile 函式會將 INF 檔案中的資訊附加至先前由 setupOpenInfFile 開啟的 INF 檔案。

語法

WINSETUPAPI BOOL SetupOpenAppendInfFileA(
  [in]      PCSTR FileName,
  [in]      HINF  InfHandle,
  [in, out] PUINT ErrorLine
);

參數

[in] FileName

如果未 NULL，FileName 會指向 null終止字串，其中包含要開啟之 INF 檔案的名稱（以及選擇性路徑）。 如果檔名不包含路徑分隔符，則會先在 %windir%\inf 目錄中搜尋，然後在 %windir%\system32 目錄中搜尋。 如果檔名包含路徑分隔符，則會假設它是完整的路徑規格，而且不會對它執行任何進一步的處理。 如果 FileNameNULL，則會從現有 INF 檔案中 Version 區段的 LayoutFile 值擷取 INF 檔名。 相同的搜尋邏輯會套用至從 LayoutFile 索引鍵擷取的檔名。

[in] InfHandle

將附加此 INF 檔案的現有 INF 句柄。

[in, out] ErrorLine

此函式會傳回載入 INF 檔案期間發生錯誤之變數的選擇性指標。此變數會傳回以 1 為基底的行號。 只有在 GetLastError 未傳回ERROR_NOT_ENOUGH_MEMORY時，這個值通常才可靠。 如果發生記憶體不足狀況，ErrorLine 可能是 0。

傳回值

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

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

如果未指定 fileName，而且現有 INF 檔案的 Version 區段中沒有 LayoutFile 值，GetLastError 會傳回ERROR_INVALID_DATA。

言論

此函式需要 Windows INF 檔案。 某些較舊的 INF 檔案格式可能不受支援。 在此情況下，函式會傳回 FALSE ，而 getLastError 會傳回ERROR_INVALID_PARAMETER。 此函式的主要目的是將 INF 檔案與 Version 區段的 LayoutFile 專案中指定的檔案中所包含的原始程式檔位置資訊（通常是 LAYOUT）。INF）。

如果 INF 檔案使用舊格式，SetupOpenAppendInfFile 也可能傳回ERROR_WRONG_INF_STYLE。

注意

setupapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 SetupOpenAppendInfFile 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 setupapi.h
連結庫 Setupapi.lib
DLL Setupapi.dll

另請參閱

函式

概觀

SetupCloseInfFile

SetupOpenInfFile