Fungsi DhcpSetOptionValues (dhcpsapi.h)

  • Artikel

Fungsi DhcpSetOptionValues mengatur kode opsi dan nilai data terkait untuk cakupan tertentu yang ditentukan pada server DHCP.

Sintaks

DWORD DHCP_API_FUNCTION DhcpSetOptionValues(
  [in] DHCP_CONST WCHAR                   *ServerIpAddress,
  [in] DHCP_CONST DHCP_OPTION_SCOPE_INFO  *ScopeInfo,
  [in] DHCP_CONST DHCP_OPTION_VALUE_ARRAY *OptionValues
);

Parameter

[in] ServerIpAddress

Penunjuk ke string Unicode yang menentukan alamat IP atau nama host server DHCP.

[in] ScopeInfo

Penunjuk ke struktur DHCP_OPTION_SCOPE_INFO yang berisi informasi yang menjelaskan tingkat (default, server, cakupan, atau reservasi IPv4) tempat nilai opsi ini akan diatur.

[in] OptionValues

Penunjuk ke struktur DHCP_OPTION_VALUE_ARRAY yang berisi daftar kode opsi dan nilai data terkait yang akan diatur untuk mereka.

Menampilkan nilai

Fungsi ini mengembalikan ERROR_SUCCESS setelah panggilan berhasil. Jika tidak, ia mengembalikan salah satu Kode Kesalahan API Manajemen Server DHCP.

Menampilkan kode Deskripsi
ERROR_DHCP_JET_ERROR
 Terjadi kesalahan saat mengakses database server DHCP.
ERROR_DHCP_OPTION_NOT_PRESENT
 Definisi opsi yang ditentukan tidak dapat ditemukan di database server DHCP.
ERROR_DHCP_SUBNET_NOT_PRESENT
 Subnet IPv4 yang ditentukan tidak ada di server DHCP.
ERROR_DHCP_NOT_RESERVED_CLIENT
 Klien DHCP yang ditentukan bukan klien yang dipesan.
ERROR_FILE_NOT_FOUND
 Cakupan multicast yang ditentukan dalam ScopeInfo tidak ditemukan di server DHCP.

Keterangan

Ketika fungsi ini dipanggil untuk pertama kalinya, fungsi ini membuat nilai opsi yang disediakan dalam database server DHCP. Jika tidak, ini memodifikasi nilai opsi untuk satu atau beberapa opsi yang terkait dengan kelas pengguna default dan kelas vendor. Nilai-nilai ini dapat diatur untuk tingkat reservasi default, server, cakupan, atau IPv4 di server DHCP.

Persyaratan

   
Klien minimum yang didukung Tidak ada yang didukung
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header dhcpsapi.h
Pustaka Dhcpsapi.lib
DLL Dhcpsapi.dll

Lihat juga

DHCP_OPTION_SCOPE_INFO

DHCP_OPTION_VALUE_ARRAY

DhcpSetOptionValue

DhcpSetOptionValuesV5