NCM_GETADDRESS pesan

Artikel
06/13/2023

Menunjukkan apakah alamat jaringan sesuai dengan jenis dan format tertentu.

NCM_GETADDRESS

    wParam = (WPARAM) (PNC_ADDRESS) pv;

    lParam = 0;

Parameter

wParam: Harus nol.
pv [masuk, keluar]: Penunjuk ke struktur NC_ADDRESS untuk menerima informasi alamat jaringan dalam bentuk yang diurai, jika format alamat dan ketik kontrol yang ditentukan oleh *hwnd* divalidasi. Aplikasi panggilan bertanggung jawab untuk mengalokasikan memori untuk struktur ini.

Menampilkan nilai

Mengembalikan salah satu nilai jenis HRESULT berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Aplikasi panggilan gagal mengalokasikan struktur NC_ADDRESS .
ERROR_INSUFFICIENT_BUFFER	Buffer keluar terlalu kecil untuk menahan alamat jaringan yang diurai.
ERROR_INVALID_PARAMETER	String alamat jaringan bukan tipe apa pun yang ditentukan.
ERROR_SUCCESS	Operasi berhasil.
S_FALSE	Tidak ada alamat dalam kontrol alamat jaringan untuk divalidasi.

Keterangan

Gunakan pesan NCM_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 mengirim pesan ini. Ini menginisialisasi pustaka kontrol umum yang berisi kontrol alamat jaringan.

Pesan 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, pesan 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. Pesan 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 di anggota PrefixLengthNC_ADDRESS adalah nol.

Atur masker tipe alamat jaringan menggunakan pesan NCM_SETALLOWTYPE sebelum Anda mengirim makro NCM_GETADDRESS .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	Shellapi.h

Lihat juga

NCM_GETALLOWTYPE
NetAddr_GetAddress

Bagikan melalui