Fungsi NetConfigurationAssignMultiString (netconfiguration.h)

Artikel
05/23/2024

Fungsi NetConfigurationAssignMultiString menetapkan sekumpulan string ke nama nilai tertentu dalam registri. String terkandung dalam kumpulan objek string kerangka kerja yang ditentukan.

Sintaks

NTSTATUS NetConfigurationAssignMultiString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] WDFCOLLECTION    Collection
);

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

Handel ke objek koleksi kerangka kerja yang mewakili kumpulan objek string kerangka kerja.

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, NetConfigurationAssignMultiString mengganti nilainya saat ini dengan nilai yang disediakan pemanggil. Jika tidak, NetConfigurationAssignMultiString 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