Bagikan melalui

SetupGetInfInformationA (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 SetUpGetInfInformation mengembalikan struktur SP_INF_INFORMATION untuk file INF yang ditentukan ke buffer.

Sintaksis

WINSETUPAPI BOOL SetupGetInfInformationA(
  [in]      LPCVOID             InfSpec,
  [in]      DWORD               SearchControl,
  [in, out] PSP_INF_INFORMATION ReturnBuffer,
  [in]      DWORD               ReturnBufferSize,
  [in, out] PDWORD              RequiredSize
);

Parameter

[in] InfSpec

Menangani atau nama file untuk file INF, tergantung pada nilai SearchControl.

[in] SearchControl

Parameter ini bisa menjadi salah satu konstanta berikut.

INFINFO_INF_SPEC_IS_HINF

InfSpec adalah handel INF. Satu handel INF dapat mereferensikan beberapa file INF jika telah dimuat tambahan bersama-sama. Jika ya, struktur yang dikembalikan oleh fungsi ini berisi beberapa set informasi.

INFINFO_INF_NAME_IS_ABSOLUTE

String yang ditentukan untuk InfSpec adalah jalur lengkap. Tidak ada pemrosesan lebih lanjut yang dilakukan pada InfSpec.

Cari lokasi default untuk file INF yang ditentukan untuk InfSpec, yang diasumsikan sebagai nama file saja. Lokasi default adalah %windir%\inf, diikuti oleh sistem %windir%\32.

Sama seperti INFINFO_DEFAULT_SEARCH, kecuali lokasi default dicari dalam urutan terbalik.

Cari INF di setiap direktori yang tercantum dalam entri nilai DevicePath di bawah berikut ini:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion

[in, out] ReturnBuffer

Jika tidak null, arahkan ke buffer di mana fungsi ini mengembalikan struktur SP_INF_INFORMATION.

Anda dapat memanggil fungsi satu kali untuk mendapatkan ukuran buffer yang diperlukan, mengalokasikan memori yang diperlukan, lalu memanggil fungsi untuk kedua kalinya untuk mengambil data. Dengan menggunakan teknik ini, Anda dapat menghindari kesalahan karena ukuran buffer yang tidak memadai. Untuk informasi selengkapnya, lihat bagian Keterangan dari topik ini.

[in] ReturnBufferSize

Ukuran ReturnBuffer, dalam byte.

[in, out] RequiredSize

Jika tidak NULL, arahkan ke variabel di mana fungsi ini mengembalikan ukuran yang diperlukan, dalam byte, untuk buffer yang ditunjukkan oleh ReturnBuffer.

Jika ReturnBuffer ditentukan dan ukuran yang diperlukan lebih besar dari ReturnBufferSize , fungsi gagal dan panggilan ke GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah 0 (nol). Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Jika file INF tidak dapat ditemukan, fungsi mengembalikan FALSE dan panggilan berikutnya ke GetLastError mengembalikan ERROR_FILE_NOT_FOUND.

Komentar

Jika fungsi ini dipanggil dengan ReturnBuffer NULL dan ReturnBufferSize 0 (nol), fungsi menempatkan ukuran buffer yang diperlukan untuk menahan data yang ditentukan ke dalam variabel yang ditunjukkan oleh RequiredSize. Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol. Jika tidak, nilai pengembalian adalah 0 (nol), dan informasi kesalahan yang diperluas dapat diperoleh dengan memanggil GetLastError.

Nota

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

Lihat juga

Functions

Gambaran Umum

SetupQueryInfFileInformation

SetupQueryInfVersionInformation

  • Last updated on