Fungsi NdisOpenConfigurationKeyByName (ndis.h)

Artikel
02/26/2024

Fungsi NdisOpenConfigurationKeyByName membuka subkunci bernama dari kunci registri terbuka tertentu yang ditunjuk oleh handel yang disediakan penelepon.

Sintaks

void NdisOpenConfigurationKeyByName(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  PNDIS_STRING SubKeyName,
  [out] PNDIS_HANDLE SubKeyHandle
);

Parameter

[out] Status

Penunjuk ke variabel yang disediakan penelepon di mana fungsi ini mengembalikan status upayanya untuk membuka kunci registri. Nilai yang mungkin dikembalikan adalah salah satu dari yang berikut ini:

NDIS_STATUS_SUCCESS

NDIS telah menginisialisasi akses ke subkunci yang ditentukan oleh SubKeyName .

NDIS_STATUS_FAILURE

Kunci tidak dapat dibuka.

[in] ConfigurationHandle

Handel ke kunci registri yang subkuntangnya harus dibuka. Biasanya, ConfigurationHandle dikembalikan oleh Fungsi NdisOpenConfigurationEx .

[in] SubKeyName

Penunjuk ke jenis NDIS_STRING yang berisi string yang disediakan penelepon, dihitung dalam kumpulan karakter default sistem yang menentukan nama subkunci registri untuk dibuka. Untuk driver Microsoft Windows 2000 dan yang lebih baru, string ini berisi karakter Unicode. Artinya, untuk Windows 2000 dan yang lebih baru, NDIS mendefinisikan jenis NDIS_STRING sebagai jenis UNICODE_STRING .

[out] SubKeyHandle

Penunjuk ke variabel yang disediakan penelepon di mana fungsi ini mengembalikan handel ke subkunci yang dibuka jika panggilan ini berhasil.

Nilai kembali

Tidak ada

Keterangan

NdisOpenConfigurationKeyByName memungkinkan driver untuk mengakses informasi konfigurasi yang disimpan dalam subkuntang bernama di registri.

Perhatikan bahwa ConfigurationHandle yang diteruskan ke NdisOpenConfigurationKeyByName dapat menjadi handel yang valid ke kunci registri yang sudah dibuka oleh pemanggil. NdisOpenConfigurationKeyByName mengembalikan informasi konfigurasi untuk subkunjung relatif terhadap ConfigurationHandle yang valid.

Setelah driver mengonsumsi dan, mungkin, memodifikasi informasi konfigurasi registri, driver harus memanggil fungsi NdisCloseConfiguration untuk merilis handel yang diperoleh dari NdisOpenConfigurationKeyByName. NdisCloseConfiguration juga membebaskan penyimpanan sementara yang dialokasikan NDIS dalam panggilan driver ke fungsi NdisReadConfiguration, NdisReadNetworkAddress, atau NdisWriteConfiguration dengan SubKeyHandle yang dikembalikan NdisOpenConfigurationKeyByName .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisOpenConfigurationKeyByName (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisOpenConfigurationKeyByName (NDIS 5.1)) di Windows XP.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	< DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_Miscellaneous_Function(ndis)