Fungsi NetConfigurationQueryBinary (netconfiguration.h)

Mengambil data yang saat ini ditetapkan ke nilai registri tertentu, menyimpan data dalam buffer yang dialokasikan kerangka kerja, dan membuat objek memori kerangka kerja untuk mewakili buffer.

Sintaks

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

Parameter

[_In_] Configuration

Handel ke objek NETCONFIGURATION yang mewakili kunci registri yang dibuka.

[_In_] ValueName

Penunjuk ke struktur UNICODE_STRING yang berisi nama nilai.

[_In_] PoolType

Nilai yang diketik POOL_TYPE yang menentukan jenis memori yang akan dialokasikan untuk buffer data.

[_In_opt_] MemoryAttributes

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

[_Out_] Memory

Penunjuk ke lokasi yang menerima handel ke objek memori baru. Kerangka kerja mengalokasikan buffer memori ini dan secara otomatis membebaskannya ketika objek NETCONFIGURATION ditutup.

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.

Memori yang dialokasikan oleh fungsi ini secara otomatis dibebaskan oleh kerangka kerja ketika objek NETCONFIGURATION ditutup.

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