SetupEnumInfSectionsA 函式 (setupapi.h)

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

SetupEnumInfSections 函式會從 INF 檔案擷取區段名稱。

語法

WINSETUPAPI BOOL SetupEnumInfSectionsA(
  [in]            HINF InfHandle,
  [in]            UINT Index,
  [out, optional] PSTR Buffer,
  [in]            UINT Size,
  [out, optional] UINT *SizeNeeded
);

參數

[in] InfHandle

要查詢之 INF 檔案的句柄。

[in] Index

要擷取之區段名稱之以零起始的索引。 當區段出現在 INF 檔案中時，此索引可能不會對應到區段的順序。

[out, optional] Buffer

接收區段名稱之緩衝區的指標。 您可以呼叫函式一次以取得必要的緩衝區大小、配置必要的記憶體，然後再次呼叫函式以擷取名稱。 使用這項技術，您可以避免緩衝區大小不足所造成的錯誤。 這是選擇性參數。 如需詳細資訊，請參閱＜備註＞一節。

[in] Size

ReturnBuffer 所指向的緩衝區大小，以字元為單位。 此數位包含終止 的NULL 字元。

[out, optional] SizeNeeded

接收 ReturnBuffer 所指向之緩衝區所需大小的位置指標。 大小會指定為儲存區段名稱所需的字元數，包括終止 的NULL 字元。

傳回值

如果函式成功，則傳回值為 TRUE。

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

如果 EnumerationIndex 的值大於或等於 INF 檔案中的區段名稱數目，GetLastError 會傳回ERROR_NO_MORE_ITEMS。

備註

此函式可以列舉 INF 檔案中的所有唯一區段名稱。 如果區段名稱在 INF 檔案中出現一次以上，則函式只會使用單一列舉索引傳回名稱一次。 若要傳回 INF 檔案中的所有區段名稱，請呼叫開頭為零的列舉索引，然後在遞增索引時對函式進行重複呼叫，直到函式傳回 FALSE 且 GetLastError 傳回 ERROR_NO_MORE_ITEMS。 您的應用程式不應該依賴根據列舉索引依任何順序傳回的區段名稱。

注意

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

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	setupapi.h
程式庫	Setupapi.lib
Dll	Setupapi.dll
API 集合	ext-ms-win-setupapi-inf-l1-1-1 (於 Windows 10 10.0.14393 版中引進)