Fungsi SetupOpenInfFileA (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 SetupOpenInfFile membuka file INF dan mengembalikan handel ke file tersebut.

Sintaksis

WINSETUPAPI HINF SetupOpenInfFileA(
  [in] PCSTR FileName,
  [in] PCSTR InfClass,
  [in] DWORD InfStyle,
  [in] PUINT ErrorLine
);

Parameter

[in] FileName

Penunjuk ke string null-terminated yang berisi nama (dan jalur opsional) dari file INF yang akan dibuka. Jika nama file tidak berisi karakter pemisah jalur, nama file dicari, pertama di direktori %windir%\inf, lalu di direktori %windir%\system32. Jika nama file berisi karakter pemisah jalur, diasumsikan sebagai spesifikasi jalur lengkap dan tidak ada pemrosesan lebih lanjut yang dilakukan di atasnya.

[in] InfClass

Penunjuk opsional ke string yang dihentikan null yang berisi kelas file INF yang diinginkan. String ini harus cocok dengan nilai Kelas dari bagian Versi (misalnya, Class=Net). Jika tidak ada entri dalam nilai Kelas, tetapi ada entri untuk ClassGUID di bagian Versi , nama kelas yang sesuai untuk GUID tersebut diambil dan digunakan untuk perbandingan.

[in] InfStyle

Gaya file INF untuk dibuka atau dicari. Parameter ini bisa menjadi kombinasi dari bendera berikut.

INF_STYLE_OLDNT

Format file INF warisan.

INF_STYLE_WIN4

Format file WINDOWS INF.

[in] ErrorLine

Penunjuk opsional ke variabel tempat fungsi ini mengembalikan nomor baris (berbasis 1) di mana terjadi kesalahan selama pemuatan file INF. Nilai ini umumnya hanya dapat diandalkan jika GetLastError tidak mengembalikan ERROR_NOT_ENOUGH_MEMORY. Jika kondisi di luar memori terjadi, ErrorLine mungkin 0.

Mengembalikan nilai

Fungsi mengembalikan handel ke file INF yang dibuka jika berhasil. Jika tidak, nilai yang dikembalikan INVALID_HANDLE_VALUE. Informasi kesalahan yang diperluas dapat diambil dengan panggilan ke GetLastError.

Komentar

Jika beban gagal karena jenis file INF tidak cocok denganInfClass , fungsi mengembalikan INVALID_HANDLE_VALUE dan panggilan ke GetLastError mengembalikan ERROR_CLASS_MISMATCH.

Jika beberapa gaya file INF ditentukan, gaya file INF yang dibuka dapat ditentukan dengan memanggil fungsi SetupGetInfInformation .

Karena mungkin ada lebih dari satu GUID kelas dengan nama kelas yang sama, pemanggil yang tertarik pada file INF dari kelas tertentu (yaitu, GUID kelas tertentu) harus mengambil nilai ClassGUID dari file INF dengan memanggil SetupQueryInfVersionInformation.

Untuk file INF warisan, string InfClass harus cocok dengan jenis yang ditentukan dalam nilai OptionType dari bagian Identifikasi dalam file INF (misalnya, OptionType=NetAdapter).

Nota

Header setupapi.h mendefinisikan SetupOpenInfFile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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
set API	ext-ms-win-setupapi-inf-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

Functions

Gambaran Umum

SetupCloseInfFile

Penyiapan GetInfInformation

SetupOpenAppendInfFile