Fungsi DhcpSetOptionValuesV5 (dhcpsapi.h)

  • Artikel

Fungsi DhcpSetOptionValuesV5 mengatur kode opsi dan nilai data terkait untuk cakupan tertentu yang ditentukan pada server DHCP. Fungsi ini memperluas fungsionalitas yang disediakan oleh DhcpSetOptionValues dengan memungkinkan pemanggil menentukan kelas dan/atau vendor untuk opsi tersebut.

Sintaks

DWORD DhcpSetOptionValuesV5(
  [in] LPWSTR                    ServerIpAddress,
  [in] DWORD                     Flags,
  [in] LPWSTR                    ClassName,
  [in] LPWSTR                    VendorName,
  [in] LPDHCP_OPTION_SCOPE_INFO  ScopeInfo,
  [in] LPDHCP_OPTION_VALUE_ARRAY OptionValues
);

Parameter

[in] ServerIpAddress

Untai (karakter) Unicode yang menentukan alamat IPv4 server DHCP.

[in] Flags

Parameter ini harus diatur ke 0 dan diabaikan setelah tanda terima.

[in] ClassName

Untai (karakter) Unicode yang menentukan kelas DHCP dari opsi. Parameter ini bersifat opsional.

[in] VendorName

Untai (karakter) Unicode yang menentukan vendor opsi. Jika tidak ada kelas vendor yang ditentukan, maka nilai opsi diatur untuk kelas vendor default. Parameter ini bersifat opsional.

[in] ScopeInfo

Penunjuk ke struktur DHCP_OPTION_SCOPE_INFO yang berisi informasi yang menjelaskan cakupan DHCP nilai opsi ini akan diatur. Parameter ini menunjukkan apakah nilai opsi diatur untuk tingkat default, server, atau cakupan, atau untuk reservasi IPv4.

[in] OptionValues

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

Nilai kembali

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_SUBNET_NOT_PRESENT
 Subnet IPv4 yang ditentukan tidak ada di server DHCP.
ERROR_DHCP_OPTION_NOT_PRESENT
 Definisi opsi yang ditentukan tidak dapat ditemukan di database server DHCP.
ERROR_DHCP_NOT_RESERVED_CLIENT
 Klien DHCP yang ditentukan bukan klien cadangan IPv4.
ERROR_DHCP_CLASS_NOT_FOUND
 Nama kelas yang ditentukan tidak dapat ditemukan di database server DHCP.

Keterangan

Pemanggil fungsi ini harus melepaskan memori yang ditunjukkan oleh OptionValues setelah panggilan selesai.

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

DhcpSetOptionValueV5

DhcpSetOptionValues