Fungsi SetupSetDirectoryIdExA (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 SetupSetDirectoryIdEx mengaitkan pengidentifikasi direktori dalam file INF dengan direktori tertentu.

Sintaksis

WINSETUPAPI BOOL SetupSetDirectoryIdExA(
  [in] HINF  InfHandle,
  [in] DWORD Id,
  [in] PCSTR Directory,
  [in] DWORD Flags,
       DWORD Reserved1,
       PVOID Reserved2
);

Parameter

[in] InfHandle

Handel untuk file INF yang dimuat.

[in] Id

Pengidentifikasi direktori (DIRID) untuk digunakan untuk asosiasi. Parameter ini dapat null. DIRID ini harus lebih besar dari atau sama dengan DIRID_USER. Jika asosiasi sudah ada untuk DIRID ini, asosiasi akan ditimpa. Jika Id adalah nol, parameter Direktori diabaikan, dan kumpulan DIRID yang ditentukan pengguna saat ini akan dihapus.

[in] Directory

Penunjuk ke stringnull yang dihentikan yang menentukan jalur direktori untuk dikaitkan dengan Id . Parameter ini dapat null. Jika Direktori NULL , direktori apa pun yang terkait dengan id tidak terkait. Tidak ada hasil kesalahan jika id saat ini tidak terkait dengan direktori.

[in] Flags

Parameter ini dapat diatur ke SETDIRID_NOT_FULL_PATH (1) untuk menunjukkan bahwa Direktori tidak menentukan jalur lengkap.

Reserved1

Jika nilai parameter ini bukan nol, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Reserved2

Jika nilai parameter ini bukan nol, fungsi mengembalikan ERROR_INVALID_PARAMETER.

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.

Komentar

SetupSetDirectoryIdEx dapat digunakan sebelum mengantre operasi penyalinan file untuk menentukan lokasi target yang hanya diketahui saat runtime.

Setelah mengatur pengidentifikasi direktori, fungsi ini melintasi semua file INF yang ditambahkan, dan jika salah satu dari mereka memiliki substitusi string yang belum terselesaikan, fungsi mencoba menerapkan kembali penggantian string berdasarkan pemetaan DIRID baru. Karena itu, beberapa nilai INF dapat berubah setelah memanggil SetupSetDirectoryIdEx.

DIRID_ABSOLUTE_16BIT bukan nilai yang valid untukId , yang memastikan kompatibilitas dengan penyiapan 16-bit.

Nota

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