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.

Sintaksis

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 di direktori file INF sistem. Untuk informasi selengkapnya tentang cara menentukan file INF, lihat bagian Keterangan berikut ini.

[out] ReturnBuffer

Penunjuk ke buffer di mana 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. Pointer ini dapat diatur ke NULL. Untuk informasi tentang cara menentukan ukuran buffer pengembalian yang diperlukan, lihat bagian Keterangan berikut ini.

[in] ReturnBufferSize

Ukuran, dalam karakter, buffer yang disediakan oleh ReturnBuffer.

[out, optional] RequiredSize

Pointer ke variabel yang diketik DWORD yang menerima ukuran, dalam karakter, dari returnBuffer buffer. 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, panggil 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.

Komentar

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 dalam RequiredSize.

Ketika penginstalan perangkat menginstal paket driver di penyimpanan driver, penginstalan 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 diterbitkan 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 INF yang sepenuhnya memenuhi syarat dalam direktori file INF sistem yang cocok dengan file INF, jika ada, yang disediakan oleh DriverStoreLocation. DriverStoreLocation harus menentukan nama file file INF yang sepenuhnya memenuhi syarat 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 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 menyediakan 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 INF yang sepenuhnya memenuhi syarat di penyimpanan driver yang sesuai dengan file INF tertentu dalam direktori file INF sistem atau file yang ditentukan di penyimpanan driver.

Nota

Header setupapi.h mendefinisikan SetupGetInfPublishedName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprocessor 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	Tersedia di Windows Vista dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupGetInfDriverStoreLocation