Fungsi NetConfigurationAssignBinary (netconfiguration.h)

Fungsi NetConfigurationAssignBinary menulis data biner yang disediakan pemanggil ke nama nilai tertentu dalam registri.

Sintaks

NTSTATUS NetConfigurationAssignBinary(
  [_In_]                             NETCONFIGURATION Configuration,
  [_In_]                             PCUNICODE_STRING ValueName,
  [__In_reads_bytes_(BufferLength)_] void             *Buffer,
  [_In_]                             ULONG            BufferLength
);

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_reads_bytes_(BufferLength)_] Buffer

Penunjuk ke buffer yang berisi data yang disediakan driver.

[_In_] BufferLength

Panjangnya, dalam byte, dari buffer tempat Buffer menunjuk.

Menampilkan nilai

Fungsi ini 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.

Jika entri dengan nama yang sama dengan ValueName sudah ada di bawah kunci registri yang dibuka, NetConfigurationAssignBinary mengganti nilainya saat ini dengan nilai yang disediakan pemanggil. Jika tidak, NetConfigurationAssignBinary menambahkan entri nilai baru dengan nama yang diberikan dan nilai yang diberikan ke registri.

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