SetupOpenAppendInfFileA (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 SetupOpenAppendInfFile menambahkan informasi dalam file INF ke file INF yang sebelumnya dibuka oleh SetupOpenInfFile.

Sintaksis

WINSETUPAPI BOOL SetupOpenAppendInfFileA(
  [in]      PCSTR FileName,
  [in]      HINF  InfHandle,
  [in, out] PUINT ErrorLine
);

Parameter

[in] FileName

Jika tidak null, FileName menunjuk ke string nulldihentikan yang berisi nama (dan secara opsional jalur) 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. Jika FileName NULL , nama file INF diambil dari nilai LayoutFile dari bagian Versi dalam file INF yang ada. Logika pencarian yang sama diterapkan ke nama file yang diambil dari kunci LayoutFile.

[in] InfHandle

Handel INF yang ada di mana file INF ini akan ditambahkan.

[in, out] 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

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 FileName tidak ditentukan dan tidak ada nilai LayoutFile di bagian Versi dari File INF yang ada, GetLastError mengembalikan ERROR_INVALID_DATA.

Komentar

Fungsi ini memerlukan file INF Windows. Beberapa format file INF yang lebih lama mungkin tidak didukung. Dalam hal ini, fungsi mengembalikan FALSE dan GetLastError akan mengembalikan ERROR_INVALID_PARAMETER. Tujuan utama fungsi ini adalah untuk menggabungkan file INF dengan informasi lokasi file sumber yang terkandung dalam file yang ditentukan dalam entri LayoutFile dari bagian Versi (biasanya, LAYOUT. INF).

ERROR_WRONG_INF_STYLE juga dapat dikembalikan oleh SetupOpenAppendInfFile jika file INF menggunakan format yang lebih lama.

Nota

Header setupapi.h mendefinisikan SetupOpenAppendInfFile 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

Lihat juga

Functions

Gambaran Umum

SetupCloseInfFile

SetupOpenInfFile