Fungsi NetConfigurationAssignMultiString (netconfiguration.h)

  • Artikel

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.

Nilai kembali

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
Header netconfiguration.h (termasuk netadaptercx.h)
IRQL PASSIVE_LEVEL