Fungsi SetupFindFirstLineA (setupapi.h)

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

Fungsi SetupFindFirstLine menemukan baris di bagian yang ditentukan dari file INF. Jika parameter KunciNULL, SetupFindFirstLine mengembalikan baris pertama bagian.

Sintaks

WINSETUPAPI BOOL SetupFindFirstLineA(
  [in]      HINF        InfHandle,
  [in]      PCSTR       Section,
  [in]      PCSTR       Key,
  [in, out] PINFCONTEXT Context
);

Parameter

[in] InfHandle

Tangani ke file INF untuk dikueri.

[in] Section

Penunjuk ke string yang dihentikan null yang menentukan bagian file INF untuk dicari.

[in] Key

Penunjuk opsional ke string yang dihentikan null yang menentukan kunci yang akan dicari di dalam bagian . String yang dihentikan null tidak boleh melebihi ukuran buffer tujuan. Parameter ini bisa NULL. Jika KunciNULL, baris pertama di bagian dikembalikan.

[in, out] Context

Penunjuk ke struktur yang menerima informasi konteks yang digunakan secara internal oleh handel INF. Aplikasi tidak boleh menimpa nilai dalam struktur ini.

Menampilkan nilai

Jika fungsi tidak dapat menemukan baris, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika parameter InfHandle mereferensikan beberapa file INF yang telah ditambahkan bersama-sama menggunakan SetupOpenAppendInfFile, fungsi SetupFindFirstLine mencari di seluruh bagian yang ditentukan di semua file yang direferensikan oleh HINF yang ditentukan.

Catatan

Header setupapi.h mendefinisikan SetupFindFirstLine sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscessor 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	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	setupapi.h
Pustaka	Setupapi.lib
DLL	Setupapi.dll
Set API	ext-ms-win-setupapi-inf-l1-1-0 (diperkenalkan dalam Windows 8)

Lihat juga

Fungsi

Gambaran Umum

SetupFindNextLine

SetupFindNextMatchLine

PenyiapanGetLineByIndex