Fungsi PxeDhcpv6GetVendorOptionValue (wdspxe.h)

Mengambil nilai opsi dari bidang OPTION_VENDOR_OPTS (17) dari paket DHCPv6.

Sintaks

DWORD PXEAPI PxeDhcpv6GetVendorOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            DWORD dwEnterpriseNumber,
  [in]            WORD  wOption,
  [in]            ULONG uInstance,
  [out, optional] PWORD pwOptionLen,
  [out, optional] PVOID *ppOptionValue
);

Parameter

[in] pPacket

Pointer ke paket balasan yang dialokasikan dengan fungsi PxePacketAllocate .

[in] uPacketLen

Panjang paket yang diacu oleh parameter pReplyPacket .

[in] dwEnterpriseNumber

Nomor Perusahaan yang ditetapkan untuk vendor opsi oleh Internet Assigned Numbers Authority (IANA).

Untuk informasi selengkapnya tentang Nomor Perusahaan yang ditetapkan, pengembang harus merujuk ke Protokol Konfigurasi Host Dinamis untuk IPv6 (RFC 3315) yang dikelola oleh The Internet Engineering Task Force (IETF).

[in] wOption

Opsi yang nilainya akan diambil.

[in] uInstance

Indeks berbasis satu yang menentukan instans parameter wOption mana yang akan diambil.

[out, optional] pwOptionLen

Alamat WORD yang akan menerima panjang nilai opsi.

[out, optional] ppOptionValue

Alamat PVOID yang akan menerima alamat nilai opsi di dalam paket.

Mengembalikan nilai

Nilai pengembalian umum tercantum dalam tabel berikut. Untuk semua kegagalan lainnya, kode galat Windows yang sesuai dikembalikan.

Mengembalikan kode/nilai	Deskripsi
ERROR_SUCCESS 0 (0x0)	Opsi ditemukan dan penunjuk ke nilai dikembalikan.
ERROR_FILE_NOT_FOUND 2 (0x2)	Opsi tidak ditemukan.
ERROR_INVALID_DATA 13 (0xD)	Paket ini bukan paket DHCP yang valid. Pengujian ini tidak menyeluruh seperti pengujian yang digunakan oleh fungsi PxeDhcpv6IsValid ; hanya panjang paket dan cookie ajaib yang diverifikasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	wdspxe.h
Pustaka	WdsPxe.lib
DLL	WdsPxe.dll

Lihat juga

PxeDhcpv6GetOptionValue

PxePacketAllocate

Fungsi Server Layanan Penyebaran Windows