struktur INTF_ENTRY
[INTF_ENTRY tidak lagi didukung pada Windows Vista dan Windows Server 2008. Sebagai gantinya , gunakan API Wifi Asli, yang menyediakan fungsionalitas serupa. Untuk informasi selengkapnya, lihat Tentang API Wifi Asli.]
Berisi informasi terperinci tentang antarmuka yang diperlukan oleh klien RPC.
Sintaks
typedef struct {
LPWSTR wszGuid;
LPWSTR wszDescr;
DWORD dwContext;
ULONG ulMediaState;
ULONG ulMediaType;
ULONG ulPhysicalMediaType;
INT nInfraMode;
INT nAuthMode;
INT nWepStatus;
DWORD dwCtlFlags;
DWORD dwDynFlags;
DWORD dwCapabilities;
RAW_DATA rdNicCapabilities;
RAW_DATA rdSSID;
RAW_DATA rdBSSID;
RAW_DATA rdBSSIDList;
RAW_DATA rdStSSIDList;
RAW_DATA rdCtrlData;
} INTF_ENTRY, *PINTF_ENTRY;
Anggota
-
wszGuid
-
Pointer ke GUID antarmuka yang diwakili sebagai string Unicode dalam format berikut: "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxx}".
-
wszDescr
-
Penunjuk ke string yang berisi deskripsi antarmuka yang diambil oleh layanan Konfigurasi Nol Nirkabel (WZCSVC).
-
dwContext
-
Dicadangkan untuk penggunaan internal.
-
ulMediaState
-
Status sambungan media NDIS saat ini untuk antarmuka. Tabel berikut ini memperlihatkan kemungkinan nilai.
Value Makna - MEDIA_STATE_CONNECTED
- 1
Media tersambung. - MEDIA_STATE_DISCONNECTED
- 0
Media terputus. - MEDIA_STATE_UNKNOWN
- -1
Status media tidak diketahui. -
ulMediaType
-
Jenis media NDIS yang saat ini digunakan NIC. Ketika dikueri, nilai anggota ini NdisMedium802_3 seperti yang didefinisikan dalam file header Ndispnp.h .
-
ulPhysicalMediaType
-
Jenis media NDIS untuk antarmuka. Ketika dikueri, nilai anggota ini adalah NdisPhysicalMediumWirelessLan seperti yang didefinisikan dalam file header Ndispnp.h .
-
nInfraMode
-
Mode Infrastruktur 802.11 saat ini diatur pada antarmuka.
-
nAuthMode
-
Mode Autentikasi 802.11 saat ini diatur pada antarmuka.
Tabel berikut menunjukkan kemungkinan nilai untuk parameter berdasarkan enumerasi NDIS_802_11_AUTHENTICATION_MODE yang ditentukan dalam file header NtDDNdis.h .
Value Makna - Ndis802_11AuthModeOpen
- 1
Autentikasi Sistem Terbuka IEEE 802.11. - Ndis802_11AuthModeShared
- 2
Autentikasi bersama IEEE 802.11 yang menggunakan kunci privasi setara kabel (WEP) yang dibagikan sebelumnya. - Ndis802_11AuthModeAutoSwitch
- 3
Mode pengalihan otomatis. Saat menggunakan mode pengalihan otomatis, kartu antarmuka jaringan nirkabel (NIC) mencoba mode autentikasi bersama terlebih dahulu. Jika mode bersama gagal, NIC mencoba menggunakan mode autentikasi terbuka. - Ndis802_11AuthModeWPA
- 4
Keamanan Akses Terlindungi Nirkabel (WPA). Autentikasi dilakukan antara server supplicant, authenticator, dan authentication melalui IEEE 802.1X. Kunci enkripsi bersifat dinamis dan diturunkan melalui proses autentikasi. - Ndis802_11AuthModeWPAPSK
- 5
Keamanan WPA menggunakan kunci yang telah dibagikan sebelumnya. Autentikasi dilakukan antara pemohon dan pengautentikasi melalui IEEE 802.1X. Kunci enkripsi bersifat dinamis dan diturunkan melalui kunci yang dibagikan sebelumnya yang digunakan oleh pemohon dan pengautentikasi. - Ndis802_11AuthModeWPANone
- 6
Keamanan WPA. Autentikasi dilakukan menggunakan kunci prabayar tanpa autentikasi IEEE 802.1X. Kunci enkripsi bersifat statis dan diturunkan melalui kunci yang telah dibagikan sebelumnya. Mode ini hanya berlaku untuk jenis jaringan ad hoc. - Ndis802_11AuthModeWPA2
- 7
Keamanan WPA2. Autentikasi dilakukan antara server supplicant, authenticator, dan authentication melalui IEEE 802.1X. Kunci enkripsi bersifat dinamis dan diturunkan melalui proses autentikasi. - Ndis802_11AuthModeWPA2PSK
- 8
Menentukan keamanan WPA2. Autentikasi dilakukan antara pemohon dan pengautentikasi melalui IEEE 802 1X. Kunci enkripsi bersifat dinamis dan diturunkan melalui kunci yang dibagikan sebelumnya yang digunakan oleh pemohon dan pengautentikasi. - Ndis802_11AuthModeMax
- 9
Nilai maksimum yang mungkin untuk nilai enumerasi NDIS_802_11_AUTHENTICATION_MODE . Ini bukan nilai hukum untuk mode autentikasi. -
nWepStatus
-
Mode Enkripsi 802.11 saat ini diatur pada antarmuka.
-
dwCtlFlags
-
Nilai bitmask bendera kontrol yang menunjukkan bagaimana WZCSVC beroperasi pada antarmuka.
Tabel berikut ini memperlihatkan kemungkinan nilai bit.
Value Makna - INTFCTL_CM_MASK
- 0x0007
Bitmask untuk mode filter jaringan. INTFCTL_CM_MASK & dwCtlFlags menghasilkan nilai jenis NDIS_802_11_NETWORK_INFRASTRUCTURE. Nilai yang dihasilkan menunjukkan apakah WZCSVC hanya terhubung ke jaringan infrastruktur, jaringan adhoc, atau ke kedua jenis jaringan. - INTFCTL_ENABLED
- 0x8000
Menunjukkan apakah WZCSVC harus mengonfigurasi antarmuka. - INTFCTL_FALLBACK
- 0x4000
Jika jaringan pilihan tidak tersedia, nilai ini menunjukkan apakah WZCSVC harus secara otomatis mengonfigurasi NIC untuk dikaitkan dengan jaringan yang tersedia. - INTFCTL_OIDSSUPP
- 0x2000
Menunjukkan apakah driver NIC mendukung semua OID 802.11 yang diperlukan oleh WZCSVC untuk berfungsi. - INTFCTL_VOLATILE
- 0x1000
Menunjukkan apakah parameter layanan untuk antarmuka ini harus dipertahankan dalam registri.
Jika nilai ini diatur, maka parameter ini volatil dan tidak boleh dipertahankan dalam registri.- INTFCTL_POLICY
- 0x0800
Menunjukkan apakah parameter layanan untuk antarmuka ini didorong oleh kebijakan grup.
Jika nilai ini diatur, maka parameter layanan didorong ke komputer lokal menurut kebijakan grup.- INTFCTL_8021XSUPP
- 0x1000
Menunjukkan apakah dukungan 802.1X diaktifkan. -
dwDynFlags
-
Bitmask bendera dinamis yang mengontrol perilaku dinamis (non-persisten dan non-statis) pada antarmuka.
Bit ini berguna untuk memicu perubahan dinamis dan sementara dalam cara WZCSVC bertindak pada antarmuka. Tidak ada bit ini yang bertahan di registri, sehingga pengaturan tidak akan bertahan dari mulai ulang sistem atau perangkat menonaktifkan dan mengaktifkan urutan.
Tabel berikut ini memperlihatkan kemungkinan nilai bit.
Value Makna - INTFDYN_NOSCAN
- 0x00000001
Menunjukkan bahwa WZCSVC tidak boleh meminta antarmuka melakukan pemindaian aktif, tetapi sebaliknya menggunakan nilai cache di driver NIC. -
dwCapabilities
-
Menentukan kemampuan driver.
Value Makna - INTFCAP_MAX_CIPHER_MASK
- 0x000000ff
Bit urutan yang lebih rendah dari anggota ini digunakan untuk menunjukkan enkripsi maksimum yang didukung. Nilai yang mungkin adalah beberapa nilai enumerasi yang ditentukan dalam struktur NDIS_802_11_WEP_STATUS dalam file header NtDDNdis.h yang disertakan dalam Windows SDK.
Nilai Ndis802_11Encryption1Enabled (2) menunjukkan bahwa WEP didukung. TKIP dan AES tidak didukung, dan kunci transmisi mungkin atau mungkin tidak tersedia.
Nilai Ndis802_11Encryption2Enabled (9) menunjukkan bahwa TKIP dan WEP didukung. AES tidak didukung, dan kunci transmisi tersedia.
Nilai Ndis802_11Encryption3Enabled (11) menunjukkan bahwa AES, TKIP, dan WEP didukung, dan kunci transmisi tersedia.
Ndis802_11EncryptionNotSupported (8) menunjukkan bahwa kunci WEP tidak didukung.- INTFCAP_SSN
- 0x00000100
Menunjukkan dukungan untuk Simple Secure Network (SSN) yang merupakan subset 802.11i.
SSN mengubah kunci enkripsi secara berkala, dibandingkan dengan standar WEP (Privasi Setara Berkabel), yang menggunakan kunci statis. Agar SSN berfungsi, sandi maksimum yang didukung harus setidaknya TKIP. SSN dikembangkan oleh konsorsium vendor pada tahun 2002 sebagai pendekatan sementara untuk meningkatkan keamanan LAN nirkabel sementara standar IEEE 802.11i sedang diselesaikan.- INTFCAP_80211I
- 0x00000200
Menunjukkan dukungan untuk standar IEEE 802.11i. -
rdNicCapabilities
-
Serangkaian kemampuan untuk 802.11i.
Fungsi WZCQueryInterface mengembalikan data rdNicCapabilities saat dipanggil dengan bendera INTF_CAPABILITIES yang diteruskan dalam parameter dwInflags . Jika panggilan fungsi berhasil, anggota pData struktur RAW_DATA berisi struktur INTF_80211_CAPABILITY .
-
rdSSID
-
Data biner yang berisi SSID 802.11 saat ini dikonfigurasi pada antarmuka.
Fungsi WZCQueryInterface mengembalikan data rdSSID saat dipanggil dengan bendera INTF_SSID yang diteruskan dalam parameter dwInflags . Jika panggilan fungsi berhasil, anggota dwDataLen dari struktur RAW_DATA berisi anggota SsidLength dari struktur NDIS_802_11_SSID dan anggota pData struktur RAW_DATA berisi anggota Ssid dari struktur NDIS_802_11_SSID .
Struktur NDIS_802_11_SSID ditentukan dalam file header Ntddndis.h.
-
rdBSSID
-
Data biner yang berisi 802.11 BSSID dikonfigurasi pada antarmuka.
Fungsi WZCQueryInterface mengembalikan data rdBSSID saat dipanggil dengan bendera INTF_BSSID yang diteruskan dalam parameter dwInflags . Jika panggilan fungsi berhasil, anggota dwDataLen dari struktur RAW_DATA berisi ukuran struktur NDIS_802_11_MAC_ADDRESS dan anggota pData dari struktur RAW_DATA berisi struktur NDIS_802_11_MAC_ADDRESS .
Struktur NDIS_802_11_MAC_ADDRESS ditentukan dalam file header Ntddndis.h.
-
rdBSSIDList
-
Data biner yang berisi daftar BSSID yang terakhir diambil oleh WZCSVC.
Fungsi WZCQueryInterface mengembalikan data rdBSSIDList saat dipanggil dengan bendera INTF_BSSIDLIST yang diteruskan dalam parameter dwInflags . Jika panggilan fungsi berhasil, anggota dwDataLen dari struktur RAW_DATA berisi panjang buffer dengan data yang dikembalikan dan anggota pData dari struktur RAW_DATA berisi struktur WZC_802_11_CONFIG_LIST .
-
rdStSSIDList
-
Data biner yang berisi daftar jaringan pilihan yang dikonfigurasi untuk antarmuka ini.
Fungsi WZCQueryInterface mengembalikan data rdStSSIDList saat dipanggil dengan bendera INTF_PREFLIST yang diteruskan dalam parameter dwInflags . Jika panggilan fungsi berhasil, anggota dwDataLen dari struktur RAW_DATA berisi panjang buffer dengan data yang dikembalikan dan anggota pData dari struktur RAW_DATA berisi struktur WZC_802_11_CONFIG_LIST .
Jika salah satu jaringan pilihan saat ini terhubung, anggota dwCtlFlags dari struktur WZC_WLAN_CONFIG untuk jaringan akan memiliki set bit WZCCTL_MEDIA_CONNECTED (0x0400).
-
rdCtrlData
-
Data biner yang digunakan dengan bendera kontrol lain, saat mengatur parameter tambahan pada antarmuka.
Keterangan
Struktur INTF_ENTRY digunakan oleh fungsi WZCQueryInterface dan WZCRefreshInterface.
Struktur RAW_DATA didefinisikan sebagai berikut:
typedef struct
{
DWORD dwDataLen;
LPBYTE pData;
} RAW_DATA, *PRAW_DATA;
Anggota pData menunjuk ke data biner. dwDataLen menunjukkan jumlah byte yang diarahkan oleh pData.
Catatan
File header Wzcsapi.h tidak tersedia di Windows SDK.
Persyaratan
| Persyaratan | Value |
|---|---|
| Klien minimum yang didukung |
Windows XP dengan SP2 [khusus aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
| Akhir dukungan klien |
Windows XP dengan SP3 |
| Akhir dukungan server |
Windows Server 2003 |
| Header |
|
Baca juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk