NetAddr_GetAddress makro (shellapi.h)

Menunjukkan apakah alamat jaringan sesuai dengan jenis dan format tertentu.

Sintaks

void NetAddr_GetAddress(
             hwnd,
  [in, out]  pv
);

Parameter

hwnd

Handel ke kontrol alamat jaringan yang berisi alamat untuk divalidasi.

[in, out] pv

Penunjuk ke struktur NC_ADDRESS untuk menerima informasi alamat jaringan dalam bentuk diurai, jika format alamat dan jenis dalam kontrol yang ditentukan oleh hwnd divalidasi. Aplikasi panggilan bertanggung jawab untuk mengalokasikan memori untuk struktur ini.

Menampilkan nilai

Tidak ada

Keterangan

Gunakan makro NetAddr_GetAddress untuk memvalidasi alamat jaringan dalam kontrol alamat jaringan terhadap masker jenis alamat jaringan yang telah ditetapkan sebelumnya. Untuk membuat instans, gunakan kelas msctls_netaddress yang ditentukan dalam Shellapi.h. Panggil InitNetworkAddressControl pada durasi sebelum memanggil makro ini. Ini menginisialisasi pustaka kontrol umum yang berisi kontrol alamat jaringan.

Makro ini mendapatkan string alamat jaringan dari kontrol alamat jaringan, mengurai string, dan memeriksa apakah string cocok dengan masker jenis alamat jaringan. Jika string cocok dengan masker, fungsi mengembalikan S_OK dan mengembalikan string dalam bentuk diurai ke aplikasi panggilan (termasuk nomor port, panjang awalan, dan informasi alamat lainnya), menggunakan struktur NC_ADDRESS yang ditujukkan oleh pv. Makro ini mengembalikan E_INVALIDARG jika aplikasi panggilan gagal mengalokasikan struktur yang diarahkan oleh pv.

Representasi alamat Protokol Internet (IP) versi 4 dan 6 (v4/v6) untuk layanan dan jaringan, serta alamat dan layanan Internet bernama yang menggunakan format Sistem Nama Domain (DNS) diurai. Jika string alamat jaringan mewakili nama host (DNS) atau layanan bernama, nilai yang dikembalikan dalam anggota PrefixLengthNC_ADDRESS adalah nol.

Atur masker tipe alamat jaringan menggunakan makro NetAddr_SetAllowType sebelum Anda memanggil makro NetAddr_GetAddress .

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shellapi.h

Lihat juga

NetAddr_GetAllowType