Fungsi NetConfigurationAssignUnicodeString (netconfiguration.h)

Artikel
05/23/2024

Fungsi NetConfigurationAssignUnicodeString menetapkan string Unicode tertentu ke nama nilai tertentu dalam registri.

Sintaks

NTSTATUS NetConfigurationAssignUnicodeString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] PCUNICODE_STRING Value
);

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_] Value

Penunjuk ke struktur UNICODE_STRING yang berisi string yang akan ditetapkan ke nama nilai yang ditentukan ValueName .

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, NetConfigurationAssignUnicodeString menggantikan nilainya saat ini dengan nilai yang disediakan pemanggil. Jika tidak, NetConfigurationAssignUnicodeString menambahkan entri nilai baru dengan nama yang diberikan dan nilai yang disediakan 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

Bagikan melalui