struktur MPR_INTERFACE_2 (mprapi.h)

Artikel
03/15/2023

Struktur MPR_INTERFACE_2 berisi data untuk antarmuka putar-nomor permintaan perute.

Sintaks

typedef struct _MPR_INTERFACE_2 {
  WCHAR                   wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1];
  HANDLE                  hInterface;
  BOOL                    fEnabled;
  ROUTER_INTERFACE_TYPE   dwIfType;
  ROUTER_CONNECTION_STATE dwConnectionState;
  DWORD                   fUnReachabilityReasons;
  DWORD                   dwLastError;
  DWORD                   dwfOptions;
  WCHAR                   szLocalPhoneNumber[RAS_MaxPhoneNumber + 1];
  PWCHAR                  szAlternates;
  DWORD                   ipaddr;
  DWORD                   ipaddrDns;
  DWORD                   ipaddrDnsAlt;
  DWORD                   ipaddrWins;
  DWORD                   ipaddrWinsAlt;
  DWORD                   dwfNetProtocols;
  WCHAR                   szDeviceType[MPR_MaxDeviceType + 1];
  WCHAR                   szDeviceName[MPR_MaxDeviceName + 1];
  WCHAR                   szX25PadType[MPR_MaxPadType + 1];
  WCHAR                   szX25Address[MPR_MaxX25Address + 1];
  WCHAR                   szX25Facilities[MPR_MaxFacilities + 1];
  WCHAR                   szX25UserData[MPR_MaxUserData + 1];
  DWORD                   dwChannels;
  DWORD                   dwSubEntries;
  DWORD                   dwDialMode;
  DWORD                   dwDialExtraPercent;
  DWORD                   dwDialExtraSampleSeconds;
  DWORD                   dwHangUpExtraPercent;
  DWORD                   dwHangUpExtraSampleSeconds;
  DWORD                   dwIdleDisconnectSeconds;
  DWORD                   dwType;
  DWORD                   dwEncryptionType;
  DWORD                   dwCustomAuthKey;
  DWORD                   dwCustomAuthDataSize;
  LPBYTE                  lpbCustomAuthData;
  GUID                    guidId;
  DWORD                   dwVpnStrategy;
} MPR_INTERFACE_2, *PMPR_INTERFACE_2;

Anggota

wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]

Penunjuk ke string Unicode yang berisi nama antarmuka.

hInterface

Handel ke antarmuka.

fEnabled

Nilai yang menentukan apakah antarmuka diaktifkan. Nilai ini TRUE jika antarmuka diaktifkan, FALSE jika antarmuka dinonaktifkan secara administratif.

dwIfType

Nilai yang mengidentifikasi jenis antarmuka.

dwConnectionState

Nilai yang menjelaskan status antarmuka saat ini, misalnya, tersambung, terputus, atau tidak dapat dijangkau. Untuk informasi selengkapnya dan daftar kemungkinan status, lihat ROUTER_CONNECTION_STATE.

fUnReachabilityReasons

Nilai yang menjelaskan alasan mengapa antarmuka tidak dapat dijangkau. Untuk informasi selengkapnya dan daftar nilai yang mungkin, lihat Alasan Tidak Dapat Dicapai.

dwLastError

Nilai yang berisi nilai bukan nol jika antarmuka gagal tersambung.

dwfOptions

Nilai yang menentukan bendera bit yang digunakan untuk mengatur opsi koneksi. Anda bisa mengatur salah satu bendera yang tercantum dalam tabel berikut ini.

Bendera	Makna
MPRIO_SpecificIpAddr	Jika bendera ini diatur, RRAS mencoba menggunakan alamat IP yang ditentukan oleh ipaddr sebagai alamat IP untuk koneksi dial-up. Jika bendera ini tidak diatur, nilai anggota ipaddr diabaikan. Mengatur bendera MPRIO_SpecificIpAddr sesuai dengan memilih pengaturan Tentukan Alamat IP dalam kotak dialog Pengaturan TCP/IP. Menghapus bendera MPRIO_SpecificIpAddr sesuai dengan memilih pengaturan Alamat IP yang Ditetapkan Server dalam kotak dialog Pengaturan TCP/IP . Saat ini, alamat IP yang diatur dalam properti entri buku telepon atau diambil dari server mengambil alih alamat IP yang diatur di panel kontrol jaringan.
MPRIO_SpecificNameServers	Jika bendera ini diatur, RRAS menggunakan anggota ipaddrDns, ipaddrDnsAlt, ipaddrWins, dan ipaddrWinsAlt untuk menentukan alamat server nama untuk koneksi dial-up. Jika bendera ini tidak diatur, RRAS mengabaikan anggota ini. Mengatur bendera MPRIO_SpecificNameServers sesuai dengan memilih pengaturan Tentukan Alamat Server Nama dalam kotak dialog Pengaturan TCP/IP. Menghapus bendera MPRIO_SpecificNameServers sesuai dengan memilih pengaturan Alamat Server Nama yang Ditetapkan Server dalam kotak dialog Pengaturan TCP/IP .
MPRIO_IpHeaderCompression	Jika bendera ini diatur, RRAS bernegosiasi untuk menggunakan pemadatan header IP pada koneksi PPP. Pemadatan header IP dapat secara signifikan meningkatkan performa. Jika bendera ini tidak diatur, kompresi header IP tidak dinegosiasikan. Bendera ini sesuai dengan kotak centang Gunakan Pemadatan Header IP dalam kotak dialog Pengaturan TCP/IP . Bendera harus dibersihkan hanya saat menyambungkan ke server yang tidak menegosiasikan kompresi header IP dengan benar.
MPRIO_RemoteDefaultGateway	Jika bendera ini diatur, rute default untuk paket IP adalah melalui adaptor dial-up saat koneksi aktif. Jika bendera ini dihapus, rute default tidak dimodifikasi. Bendera ini sesuai dengan kotak centang Gunakan Gateway Default di Jaringan Jarak Jauh dalam kotak dialog Pengaturan TCP/IP .
MPRIO_DisableLcpExtensions	Jika bendera ini diatur, RRAS menonaktifkan ekstensi LCP PPP yang ditentukan dalam RFC 1570. Menonaktifkan ekstensi PPP LCP mungkin diperlukan untuk terhubung ke implementasi PPP tertentu yang lebih lama, tetapi mengganggu fitur seperti panggilan balik server. Jangan atur bendera ini kecuali secara khusus diperlukan.
MPRIO_SwCompression	Jika bendera ini diatur, kompresi perangkat lunak dinegosiasikan pada tautan. Pengaturan bendera ini menyebabkan driver PPP mencoba menegosiasikan Compression Control Protocol (CCP) dengan server. Bendera ini harus diatur secara default, tetapi menghapusnya dapat mengurangi periode negosiasi jika server tidak mendukung protokol kompresi yang kompatibel.
MPRIO_RequireEncryptedPw	Jika bendera ini diatur, hanya skema kata sandi aman yang dapat digunakan untuk mengautentikasi klien dengan server. Ini mencegah driver PPP menggunakan protokol autentikasi teks biasa PAP untuk mengautentikasi klien. Namun, protokol autentikasi MS-CHAP, MD5-CHAP, dan SPAP didukung. Untuk peningkatan keamanan, atur bendera ini. Untuk meningkatkan interoperabilitas, hapus bendera ini. Bendera ini sesuai dengan kotak centang Perlu Kata Sandi Terenkripsi dalam kotak dialog Keamanan . Untuk informasi selengkapnya, lihat MPRIO_RequireMsEncryptedPw.
MPRIO_RequireMsEncryptedPw	Jika bendera ini diatur, hanya skema kata sandi aman Microsoft yang dapat digunakan untuk mengautentikasi klien dengan server. Ini mencegah driver PPP menggunakan protokol autentikasi teks biasa PAP, MD5-CHAP, atau SPAP. Untuk peningkatan keamanan, atur bendera ini. Untuk meningkatkan interoperabilitas, hapus bendera ini. Bendera ini lebih diutamakan daripada MPRIO_RequireEncryptedPw. Bendera ini sesuai dengan kotak centang Perlu Kata Sandi Terenkripsi Microsoft dalam kotak dialog Keamanan . Untuk informasi selengkapnya, lihat MPRIO_RequireDataEncryption.
MPRIO_RequireDataEncryption	Jika bendera ini diatur, enkripsi data harus berhasil dinegosiasikan atau koneksi harus dihilangkan. Bendera ini diabaikan kecuali MPRIO_RequireMsEncryptedPw juga diatur. Bendera ini sesuai dengan kotak centang Perlu Enkripsi Data dalam kotak dialog Keamanan .
MPRIO_NetworkLogon	Bendera ini dicadangkan untuk digunakan di masa mendatang.
MPRIO_UseLogonCredentials	Jika bendera ini diatur, RRAS menggunakan nama pengguna, kata sandi, dan domain pengguna yang saat ini masuk saat memutar nomor entri ini. Bendera ini diabaikan kecuali MPRIO_RequireMsEncryptedPw juga diatur. Pengaturan ini diabaikan oleh fungsi RasDial di mana menentukan string kosong untuk anggota szUserName dan szPassword dari struktur RASDIALPARAMS memberikan hasil yang sama. Bendera ini sesuai dengan kotak centang Gunakan Nama Pengguna dan Kata Sandi Saat Ini dalam kotak dialog Keamanan .
MPRIO_PromoteAlternates	Bendera ini berpengaruh ketika nomor telepon alternatif ditentukan oleh anggota szAlternates . Jika bendera ini diatur, nomor telepon alternatif yang berhasil tersambung menjadi nomor telepon utama, dan nomor telepon utama saat ini dipindahkan ke daftar alternatif. Bendera ini sesuai dengan kotak centang dalam kotak dialog Nomor Alternatif .
MPRIO_SecureLocalFiles	Jika bendera ini diatur, RRAS memeriksa sistem file jarak jauh yang ada dan pengikatan printer jarak jauh sebelum membuat koneksi dengan entri ini. Biasanya, Anda mengatur bendera ini pada entri buku telepon untuk jaringan publik untuk mengingatkan pengguna untuk memutuskan koneksi ke jaringan privat mereka sebelum menyambungkan ke jaringan publik.
MPRIO_RequireEAP	Jika bendera ini diatur, Extensible Authentication Protocol (EAP) harus didukung untuk autentikasi.
MPRIO_RequirePAP	Jika bendera ini diatur, Protokol Autentikasi Kata Sandi harus didukung untuk autentikasi.
MPRIO_RequireSPAP	Jika bendera ini diatur, Protokol Autentikasi Kata Sandi (SPAP) Shiva harus didukung untuk autentikasi.
MPRIO_SharedPhoneNumbers	Jika bendera ini diatur, nomor telepon akan dibagikan.
MPRIO_RequireCHAP	Jika bendera ini diatur, Protokol Autentikasi Jabat Tangan Tantangan harus didukung untuk autentikasi.
MPRIO_RequireMsCHAP	Jika bendera ini diatur, Protokol Autentikasi Jabat Tangan Microsoft Challenge harus didukung untuk autentikasi.
MPRIO_RequireMsCHAP2	Jika bendera ini diatur, versi 2 dari Protokol Autentikasi Jabat Tangan Microsoft Challenge harus didukung untuk autentikasi.
MPRIO_IpSecPreSharedKey	Jika bendera ini diatur untuk dwfOptions dalam struktur MPR_INTERFACE_2 dan digunakan di MprAdminInterfaceSetInfo, bendera ini mengonfigurasi antarmuka putar nomor permintaan untuk menggunakan kunci yang dibagikan sebelumnya.
MPRIO_RequireMachineCertificates	Windows 8 atau yang lebih baru: Jika bendera ini diatur, sertifikat komputer digunakan untuk autentikasi IKEv2.
MPRIO_UsePreSharedKeyForIkev2Initiator	Windows 8 atau yang lebih baru: Jika bendera ini diatur, kunci yang dibagikan sebelumnya digunakan oleh inisiator koneksi IKEv2 untuk autentikasi.
MPRIO_UsePreSharedKeyForIkev2Responder	Windows 8 atau yang lebih baru: Jika bendera ini diatur, kunci yang dibagikan sebelumnya digunakan oleh responden koneksi IKEv2 untuk autentikasi.

szLocalPhoneNumber[RAS_MaxPhoneNumber + 1]

Nilai yang menentukan string yang dihentikan null yang berisi nomor telepon.

szAlternates

Penunjuk ke daftar string Unicode yang dihentikan null berturut-turut. String terakhir dihentikan oleh dua karakter null berturut-turut. String adalah nomor telepon alternatif yang ditelepon perute, dalam urutan yang tercantum, jika nomor utama gagal tersambung. Untuk informasi selengkapnya, lihat szLocalPhoneNumber.

ipaddr

Nilai yang menentukan alamat IP yang akan digunakan saat koneksi ini aktif. Anggota ini diabaikan kecuali dwfOptions menentukan bendera MPRIO_SpecificIpAddr .

ipaddrDns

Nilai yang menentukan alamat IP server DNS yang akan digunakan saat koneksi ini aktif. Anggota ini diabaikan kecuali dwfOptions menentukan bendera MPRIO_SpecificNameServers .

ipaddrDnsAlt

Nilai yang menentukan alamat IP server DNS sekunder atau cadangan yang akan digunakan saat koneksi ini aktif. Anggota ini diabaikan kecuali dwfOptions menentukan bendera MPRIO_SpecificNameServers .

ipaddrWins

Nilai yang menentukan alamat IP server WINS yang akan digunakan saat koneksi ini aktif. Anggota ini diabaikan kecuali dwfOptions menentukan bendera MPRIO_SpecificNameServers .

ipaddrWinsAlt

Nilai yang menentukan alamat IP server WINS sekunder yang akan digunakan saat koneksi ini aktif. Anggota ini diabaikan kecuali dwfOptions menentukan bendera MPRIO_SpecificNameServers .

dwfNetProtocols

Nilai yang menentukan protokol jaringan untuk dinegosiasikan. Anggota ini bisa menjadi kombinasi dari bendera berikut.

Bendera	Makna
MPRNP_Ipx	Negosiasikan protokol IPX.
MPRNP_Ip	Negosiasikan protokol TCP/IP.

Windows 64-bit: Bendera MPRNP_Ipx tidak didukung

szDeviceType[MPR_MaxDeviceType + 1]

Nilai yang menentukan string yang dihentikan null yang menunjukkan jenis perangkat RRAS yang dirujuk oleh szDeviceName. Anggota ini bisa menjadi salah satu konstanta string berikut.

String	Makna
MPRDT_Modem	Modem yang diakses melalui port COM.
MPRDT_Isdn	Adaptor ISDN dengan driver NDISWAN yang sesuai terinstal.
MPRDT_X25	Adaptor X.25 dengan driver NDISWAN yang sesuai terinstal.
MPRDT_Vpn	Koneksi jaringan privat maya (VPN).
MPRDT_Pad	Perakitan/pembakar paket.
MPRDT_Generic	Generik.
MPRDT_Serial	Koneksi serial langsung melalui port serial.
MPRDT_FrameRelay	Frame Relay.
MPRDT_Atm	Mode Transfer Asinkron.
MPRDT_Sonet	Sonet.
MPRDT_SW56	Akses 56K yang dialihkan.
MPRDT_Irda	Perangkat yang mematuhi Asosiasi Data Inframerah (IrDA).
MPRDT_Parallel	Koneksi paralel langsung melalui port paralel.

szDeviceName[MPR_MaxDeviceName + 1]

Berisi string yang dihentikan null yang berisi nama perangkat TAPI untuk digunakan dengan entri buku telepon ini, misalnya, "Fabrikam Inc 28800 External". Untuk menghitung semua perangkat berkemampuan RAS yang tersedia, gunakan fungsi RasEnumDevices .

szX25PadType[MPR_MaxPadType + 1]

Jenis data yang berisi string yang dihentikan null yang mengidentifikasi jenis PAD X.25. Atur anggota ini ke string kosong ("") kecuali entri harus memanggil menggunakan PAD X.25.

Windows 2000 dan Windows NT: String szX25PadType memetakan ke nama bagian di PAD.INF.

szX25Address[MPR_MaxX25Address + 1]

Berisi string yang dihentikan null yang mengidentifikasi alamat X.25 untuk disambungkan. Atur anggota ini ke string kosong ("") kecuali entri harus memanggil menggunakan PAD X.25 atau perangkat X.25 asli.

szX25Facilities[MPR_MaxFacilities + 1]

Berisi string yang dihentikan null yang menentukan fasilitas untuk diminta dari host X.25 pada waktu koneksi. Anggota ini diabaikan jika szX25Address adalah string kosong ("").

szX25UserData[MPR_MaxUserData + 1]

Berisi string yang dihentikan null yang menentukan data koneksi tambahan yang disediakan ke host X.25 pada waktu koneksi. Anggota ini diabaikan jika szX25Address adalah string kosong ("").

dwChannels

Disiapkan untuk penggunaan masa mendatang.

dwSubEntries

Nilai yang menentukan jumlah subentri multilink yang terkait dengan entri ini. Saat memanggil RasSetEntryProperties, atur anggota ini ke nol. Untuk menambahkan subentri ke entri buku telepon, gunakan fungsi RasSetSubEntryProperties .

dwDialMode

Menunjukkan apakah RRAS harus melakukan panggilan ke semua subentri multilink entri ini ketika entri pertama kali tersambung. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
MPRDM_DialAll	Putar semua subentri pada awalnya.
MPRDM_DialAsNeeded	Sesuaikan jumlah subentri saat bandwidth diperlukan. RRAS menggunakan anggota dwDialExtraPercent, dwDialExtraSampleSeconds, dwDialHangUpExtraPercent, dan dwHangUpExtraSampleSeconds untuk menentukan kapan harus memutar atau memutuskan subentry.

dwDialExtraPercent

Nilai yang menentukan persentase total bandwidth yang tersedia dari subentri yang saat ini tersambung. RRAS memutar subentri tambahan ketika total bandwidth yang digunakan melebihi dwDialExtraPercent persen dari bandwidth yang tersedia setidaknya selama dwDialExtraSampleSeconds detik.

Anggota ini diabaikan kecuali anggota dwDialMode menentukan bendera MPRDM_DialAsNeeded .

dwDialExtraSampleSeconds

Nilai yang menentukan waktu, dalam detik, yang penggunaan bandwidth saat ini harus melebihi ambang batas yang ditentukan oleh dwDialExtraPercent sebelum RRAS memanggil subentri tambahan.

Anggota ini diabaikan kecuali anggota dwDialMode menentukan bendera MPRDM_DialAsNeeded .

dwHangUpExtraPercent

Nilai yang menentukan persentase total bandwidth yang tersedia dari subentri yang saat ini tersambung. RRAS mengakhiri (menutup) koneksi subentry yang ada ketika total bandwidth yang digunakan kurang dari dwHangUpExtraPercent dari bandwidth yang tersedia setidaknya selama dwHangUpExtraSampleSeconds detik.

Anggota ini diabaikan kecuali anggota dwDialMode menentukan bendera MPRDM_DialAsNeeded .

dwHangUpExtraSampleSeconds

Nilai yang menentukan waktu, dalam detik, yang penggunaan bandwidth saat ini harus kurang dari ambang batas yang ditentukan oleh dwHangUpExtraPercent sebelum RRAS mengakhiri koneksi subentri yang ada.

Anggota ini diabaikan kecuali anggota dwDialMode menentukan bendera MPRDM_DialAsNeeded .

dwIdleDisconnectSeconds

Nilai yang menentukan waktu, dalam detik, setelah itu koneksi tidak aktif dihentikan. Kecuali waktu diam habis dinonaktifkan, seluruh koneksi dihentikan jika koneksi menganggur untuk interval yang ditentukan. Anggota ini dapat menentukan nilai waktu habis, atau salah satu nilai berikut.

Nilai	Makna
MPRIDS_Disabled	Tidak ada batas waktu menganggur untuk sambungan ini.
MPRIDS_UseGlobalValue	Gunakan nilai preferensi pengguna sebagai default.

dwType

Nilai yang menentukan jenis entri buku telepon. Anggota ini bisa menjadi salah satu jenis berikut.

Jenis	Makna
MPRET_Phone	Saluran telepon, misalnya, modem, ISDN, atau X.25.
MPRET_Vpn	Jaringan Privat Maya.
MPRET_Direct	Koneksi serial atau paralel langsung.

dwEncryptionType

Nilai yang menentukan jenis enkripsi yang akan digunakan untuk Microsoft Point-to-Point Encryption (MPPE) dengan koneksi. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
MPR_ET_None	Jangan gunakan enkripsi.
MPR_ET_Require	Gunakan enkripsi.
MPR_ET_RequireMax	Gunakan enkripsi kekuatan maksimum.
MPR_ET_Optional	Jika memungkinkan, gunakan enkripsi.

Nilai dwEncryptionType tidak memengaruhi cara kata sandi dienkripsi. Apakah kata sandi dienkripsi dan bagaimana kata sandi dienkripsi ditentukan oleh protokol autentikasi, misalnya, PAP, MS-CHAP, atau EAP.

dwCustomAuthKey

Nilai yang menentukan kunci autentikasi yang akan diberikan kepada vendor Extensible Authentication Protocol (EAP).

dwCustomAuthDataSize

Nilai yang menentukan ukuran data yang ditunjukkan oleh anggota lpbCustomAuthData .

lpbCustomAuthData

Pointer ke data autentikasi untuk digunakan dengan EAP.

guidId

Pengidentifikasi unik global (GUID) yang mewakili entri buku telepon ini. Anggota ini baca-saja.

dwVpnStrategy

Strategi VPN yang digunakan saat memutar-nomor koneksi VPN. Anggota ini bisa memiliki salah satu nilai berikut.

Nilai	Makna
MPR_VS_Default	RRAS menekan PPTP terlebih dahulu. Jika PPTP gagal, L2TP dicoba. Protokol yang berhasil dicoba terlebih dahulu dalam putar-nomor berikutnya untuk entri ini.
MPR_VS_PptpOnly	RAS hanya menekan PPTP.
MPR_VS_PptpFirst	RAS selalu memanggil PPTP terlebih dahulu, L2TP detik.
MPR_VS_L2tpOnly	RAS hanya menekan L2TP.
MPR_VS_L2tpFirst	RAS memanggil L2TP terlebih dahulu, pptp detik.