SetupSetPlatformPathOverrideA (setupapi.h)

[Fungsi ini tersedia untuk digunakan dalam sistem operasi yang ditunjukkan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. SetupAPI tidak boleh lagi digunakan untuk menginstal aplikasi. Sebagai gantinya, gunakan Penginstal Windows untuk mengembangkan penginstal aplikasi. PenyetelanAPI terus digunakan untuk menginstal pengandar perangkat.]

Fungsi SetupSetPlatformPathOverride digunakan untuk mengatur penggantian jalur platform untuk komputer target saat bekerja dengan INF dari komputer yang berbeda. Dengan demikian, ini dapat merujuk ke platform yang berbeda dari yang saat ini berjalan. Untuk berurusan dengan sumber media, dapat merujuk ke platform yang tidak lagi didukung, seperti Alpha, MIPS, dan PPC. Ini menghapus penimpaan jalur platform jika tidak ada yang ditentukan.

Sintaksis

WINSETUPAPI BOOL SetupSetPlatformPathOverrideA(
  [in] PCSTR Override
);

Parameter

[in] Override

Penunjuk ke stringnull yang dihentikan yang berisi informasi platform pengganti. Misalnya, "alpha" atau "x86". Parameter ini mungkin null.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Jika GetLastError mengembalikan ERROR_NOT_ENOUGH_MEMORY, SetupSetPlatformPathOverride tidak dapat menyimpan string Penggantian .

Komentar

SetPlatformPathOverride digunakan untuk mengubah jalur sumber saat mengantre file. Jika pengambilalihan jalur platform telah diatur oleh panggilan ke SetPlatformPathOverride, fungsi penyiapan apa pun yang mengantre operasi penyalinan file akan memeriksa komponen akhir jalur sumber dan jika komponen akhir cocok dengan nama platform pengguna, ganti dengan string penggantian yang ditetapkan oleh SetPlatformPathOverride.

Misalnya, pertimbangkan mesin platform MIPS tempat platform telah diatur ke Alpha dengan panggilan ke SetPlatformPathOverride. Setelah penimpaan jalur platform diatur, operasi penyalinan file diantrekan dengan jalur sumber \pop\top\baz\mips\x.exe, the path will be changed to \pop\top\baz\alpha\x.exe.

Jalur operasi penyalinan file yang diantrekan sebelum penimpaan jalur diatur tidak diubah.

Nota

Header setupapi.h mendefinisikan SetupSetPlatformPathOverride sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	setupapi.h
Pustaka	Setupapi.lib
DLL	Setupapi.dll

Lihat juga

Functions

Gambaran Umum

SetupSetDirectoryId