SetupGetInfPublishedNameW (setupapi.h)
Fungsi SetupGetInfPublishedName mengambil nama file yang sepenuhnya memenuhi syarat (jalur direktori dan nama file) dari file INF dalam direktori file INF sistem yang sesuai dengan file INF tertentu di penyimpanan driver atau file INF tertentu dalam direktori file INF sistem.
Sintaks
WINSETUPAPI BOOL SetupGetInfPublishedNameW(
[in] PCWSTR DriverStoreLocation,
[out] PWSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] DriverStoreLocation
Penunjuk ke string yang dihentikan NULL yang berisi nama file yang sepenuhnya memenuhi syarat (jalur direktori dan nama file) dari file INF di penyimpanan driver. Atau, parameter ini adalah penunjuk ke string yang dihentikan NULL yang berisi nama, dan secara opsional jalur direktori lengkap, dari file INF dalam direktori file INF sistem. Untuk informasi selengkapnya tentang cara menentukan file INF, lihat bagian Keterangan berikut.
[out] ReturnBuffer
Penunjuk ke buffer tempat SetupGetInfPublishedName mengembalikan string yang dihentikan NULL yang berisi nama file yang sepenuhnya memenuhi syarat dari file INF yang ditentukan dalam direktori INF sistem. Ukuran jalur maksimum adalah MAX_PATH. Penunjuk ini dapat diatur ke NULL. Untuk informasi tentang cara menentukan ukuran buffer pengembalian yang diperlukan, lihat bagian Keterangan berikut.
[in] ReturnBufferSize
Ukuran, dalam karakter, dari buffer yang disediakan oleh ReturnBuffer.
[out, optional] RequiredSize
Penunjuk ke variabel berjenis DWORD yang menerima ukuran, dalam karakter, dari buffer ReturnBuffer . Parameter ini bersifat opsional dan dapat diatur ke NULL.
Mengembalikan nilai
Jika SetupGetInfPublishedName berhasil, fungsi mengembalikan TRUE; jika tidak, fungsi mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Jika ukuran, dalam karakter, dari nama file yang sepenuhnya memenuhi syarat dari file INF yang diminta, termasuk terminator null, lebih besar dari ReturnBufferSize, fungsi akan gagal, dan panggilan ke GetLastError akan mengembalikan ERROR_INSUFFICIENT_BUFFER.
Keterangan
Untuk menentukan ukuran buffer pengembalian yang diperlukan untuk berisi nama file yang sepenuhnya memenuhi syarat dari file INF yang ditentukan dalam direktori INF sistem, panggil SetupGetInfPublishedName dan atur ReturnBuffer ke NULL, ReturnBufferSize ke nol, dan berikan RequiredSize. SetupGetInfPublishedName akan mengembalikan ukuran buffer yang diperlukan di RequiredSize.
Ketika penginstalan perangkat telah menginstal paket driver di penyimpanan driver, itu membuat dua salinan file INF paket driver. Penginstalan perangkat menambahkan satu salinan ke direktori INF sistem dan menetapkan salinan file INF tersebut nama file unik yang diterbitkan dari formulir OEMnnn.inf. Penginstalan perangkat menambahkan salinan kedua file INF ke penyimpanan driver dan menetapkan yang menyalin nama file INF asli.
SetupGetInfPublishedName mengembalikan nama file yang sepenuhnya memenuhi syarat dari file INF dalam direktori file INF sistem yang cocok dengan file INF, jika ada, yang disediakan oleh DriverStoreLocation. DriverStoreLocation harus menentukan nama file yang sepenuhnya memenuhi syarat dari file INF di penyimpanan driver atau harus menentukan nama file, dan secara opsional jalur direktori, dari file INF dalam direktori INF sistem. Misalnya, asumsikan bahwa file INF untuk paket driver adalah myinf.inf, dan untuk paket driver ini, penginstalan perangkat menginstal file INF OEM1.inf di direktori INF sistem C:\Windows\inf. Selanjutnya asumsikan bahwa penginstalan perangkat menginstal salinan file INF yang sesuai C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf di penyimpanan driver. Dalam hal ini, fungsi mengembalikan C:\Windows\inf\OEM1.inf jika DriverStoreLocation memasok salah satu string berikut: C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf, OEM1.inf, atau C:\Windows\inf\OEM1.inf.
Panggil fungsi SetupGetInfDriverStoreLocation untuk mengambil nama file yang sepenuhnya memenuhi syarat dari file INF di penyimpanan driver yang sesuai dengan file INF tertentu dalam direktori file INF sistem atau file tertentu di penyimpanan driver.
Catatan
Header setupapi.h mendefinisikan SetupGetInfPublishedName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows Vista dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |