Fungsi SetupFindFirstLineW (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 SetupFindFirstLine menemukan baris di bagian yang ditentukan dari file INF. Jika parameter Kunci null, SetupFindFirstLine mengembalikan baris pertama bagian.

Sintaksis

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

Parameter

[in] InfHandle

Tangani ke file INF untuk dikueri.

[in] Section

Penunjuk ke untai (karakter) nullyang dihentikan yang menentukan bagian file INF yang akan dicari.

[in] Key

Penunjuk opsional ke string nulldihentikan yang menentukan kunci yang akan dicari di dalam bagian . String null-dihentikan tidak boleh melebihi ukuran buffer tujuan. Parameter ini dapat null. Jika KeyNULL, 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.

Mengembalikan nilai

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

Komentar

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

Nota

Header setupapi.h mendefinisikan SetupFindFirstLine sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

SetupFindNextLine

SetupFindNextMatchLine

SetupGetLineByIndex