SetupGetTargetPathW 函式（setupapi.h）

發行項
11/20/2024

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

SetupGetTargetPath 函式會決定檔案清單區段的目標目錄。檔案清單區段可以是 複製檔案 區段、刪除檔案 區段，或 重新命名檔案 區段。區段中的所有檔案都必須位於 INF 檔案 DestinationDirs 區段中所列的單一目錄中。

語法

WINSETUPAPI BOOL SetupGetTargetPathW(
  [in]      HINF        InfHandle,
  [in]      PINFCONTEXT InfContext,
  [in]      PCWSTR      Section,
  [in, out] PWSTR       ReturnBuffer,
  [in]      DWORD       ReturnBufferSize,
  [in, out] PDWORD      RequiredSize
);

參數

[in] InfHandle

處理包含 DestinationDirs 區段的載入 INF 檔案。

[in] InfContext

INF 內容的選擇性指標，指定要擷取目的地目錄之檔案清單區段中的一行。如果 InfContextNULL，則會使用 Section 參數。

[in] Section

選擇性參數，指定 INF 檔案的區段名稱，該區段的句柄 InfHandle。 SetupGetTargetPath 擷取本節的目標目錄。如果指定 InfContext，則會忽略 Section 參數。如果未指定 InfContext 或 Section，函式會從 INF 檔案擷取預設目標路徑。您應該使用 null-terminated 字串。

[in, out] ReturnBuffer

要接收完整目標路徑之緩衝區的選擇性指標。路徑保證不會以結尾。您應該使用 null-terminated 字串。您可以呼叫函式一次以取得所需的緩衝區大小、配置必要的記憶體，然後第二次呼叫函式來擷取數據。使用這項技術，您可以避免因為緩衝區大小不足而發生錯誤。請參閱一節。此參數可以是 NULL。

[in] ReturnBufferSize

以字元表示 ReturnBuffer所指向的緩衝區大小。這包括 null 終止符。

[in, out] RequiredSize

變數的選擇性指標，該變數會以字元表示 ReturnBuffer所指向之緩衝區所需的大小。這包括 null 終止符。如果所需的實際大小大於 returnBufferSize 所指定的值，則函式會失敗，而且 GetLastError 的呼叫會傳回ERROR_INSUFFICIENT_BUFFER。

傳回值

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

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

言論

如果使用 NULL 的 ReturnBuffer 和零的 ReturnBufferSize 呼叫，則函式會將所需的緩衝區大小放入 RequiredSizeRequiredSize 所指向的變數中。如果函式成功，則傳回值是非零值。否則，傳回值為零，而且可以呼叫 getLastError取得擴充錯誤資訊。

注意

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

要求

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