Fungsi NetConfigurationQueryString (netconfiguration.h)

Artikel
05/23/2024

Mengambil nilai string yang ditentukan dari objek konfigurasi adaptor dan menetapkan string ke objek string kerangka kerja tertentu.

Sintaks

NTSTATUS NetConfigurationQueryString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringAttributes,
  [_Out_]    WDFSTRING             *WdfString
);

Parameter

[_In_] Configuration

Tangani ke objek NETCONFIGURATION yang mewakili kunci registri yang dibuka.

[_In_] ValueName

Penunjuk ke struktur UNICODE_STRING yang berisi nama untuk nilai string.

[_In_opt_] StringAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang berisi atribut yang disediakan driver untuk objek WDFSTRING baru. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] WdfString

Handel ke objek string kerangka kerja. NetAdapterCx akan menetapkan data string nilai registri ke objek ini.

Menampilkan nilai

Fungsi mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi ini dapat mengembalikan kode kesalahan NTSTATUS yang sesuai.

Keterangan

Driver klien mendapatkan handel ke objek NETCONFIGURATION dengan memanggil NetAdapterOpenConfiguration atau NetConfigurationOpenSubConfiguration.

Secara default, objek string kerangka kerja diindukkan ke objek koleksi. Driver klien dapat mengubah ini dengan mengatur anggota ParentObject dari struktur WDF_OBJECT_ATTRIBUTES .

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1.21
Versi UMDF minimum	2.33
Header	netconfiguration.h (termasuk netadaptercx.h)
IRQL	PASSIVE_LEVEL

Bagikan melalui