MPR_INTERFACE_3-Struktur (mprapi.h)
Die MPR_INTERFACE_3-Struktur enthält Daten für eine Router-Bedarfswahlschnittstelle.
Syntax
typedef struct _MPR_INTERFACE_3 {
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;
ULONG AddressCount;
IN6_ADDR ipv6addrDns;
IN6_ADDR ipv6addrDnsAlt;
IN6_ADDR *ipv6addr;
} MPR_INTERFACE_3, *PMPR_INTERFACE_3;
Members
wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen der Schnittstelle enthält.
hInterface
Ein Handle für die Schnittstelle.
fEnabled
Ein -Wert, der angibt, ob die Schnittstelle aktiviert ist. Dieser Wert ist TRUE , wenn die Schnittstelle aktiviert ist, FALSE , wenn die Schnittstelle administrativ deaktiviert ist.
dwIfType
Ein -Wert, der den Schnittstellentyp identifiziert.
dwConnectionState
Ein -Wert, der den aktuellen Zustand der Schnittstelle beschreibt, z. B. verbunden, getrennt oder nicht erreichbar. Weitere Informationen und eine Liste der möglichen Zustände finden Sie unter ROUTER_CONNECTION_STATE.
fUnReachabilityReasons
Ein -Wert, der den Grund beschreibt, warum die Schnittstelle nicht erreichbar ist. Weitere Informationen und eine Liste der möglichen Werte finden Sie unter Gründe für die Nichterreichbarkeit.
dwLastError
Ein -Wert, der einen Wert ungleich Null enthält, wenn die Schnittstelle keine Verbindung herstellen kann.
dwfOptions
Ein -Wert, der Bitflags angibt, die zum Festlegen von Verbindungsoptionen verwendet werden. Sie können eines der in der folgenden Tabelle aufgeführten Flags festlegen.
| Flag | Bedeutung |
|---|---|
|
Wenn dieses Flag festgelegt ist, versucht RRAS, die von ipaddr angegebene IP-Adresse als IP-Adresse für die DFÜ-Verbindung zu verwenden. Wenn dieses Flag nicht festgelegt ist, wird der Wert des ipaddr-Elements ignoriert.
Das Festlegen des MPRIO_SpecificIpAddr Flags entspricht der Auswahl der Einstellung IP-Adresse angeben im Dialogfeld TCP/IP-Einstellungen. Das Löschen des MPRIO_SpecificIpAddr Flags entspricht der Auswahl der Einstellung Serverseitig zugewiesene IP-Adresse im Dialogfeld TCP/IP-Einstellungen . Derzeit überschreibt eine IP-Adresse, die in den Eigenschaften des Telefonbucheintrags festgelegt oder von einem Server abgerufen wird, die IP-Adresse, die in der Netzwerksteuerung festgelegt wurde. |
|
Wenn dieses Flag festgelegt ist, verwendet RRAS die Member ipaddrDns, ipaddrDnsAlt, ipaddrWins und ipaddrWinsAlt , um die Namenserveradressen für die DFÜ-Verbindung anzugeben. Wenn dieses Flag nicht festgelegt ist, ignoriert RRAS diese Member.
Das Festlegen des MPRIO_SpecificNameServers Flags entspricht der Auswahl der Einstellung Name Server-Adressen angeben im Dialogfeld TCP/IP-Einstellungen. Das Löschen des MPRIO_SpecificNameServers Flags entspricht der Auswahl der Einstellung Server mit serverseitig zugewiesenen Namen Serveradressen im Dialogfeld TCP/IP-Einstellungen . |
|
Wenn dieses Flag festgelegt ist, handelt RRAS aus, um die IP-Headerkomprimierung für PPP-Verbindungen zu verwenden. Die IP-Headerkomprimierung kann die Leistung erheblich verbessern.
Wenn dieses Flag nicht festgelegt ist, wird die IP-Headerkomprimierung nicht ausgehandelt. Dieses Flag entspricht dem Kontrollkästchen IP-Headerkomprimierung verwenden im Dialogfeld TCP/IP-Einstellungen . Das Flag sollte nur deaktiviert werden, wenn eine Verbindung mit einem Server hergestellt wird, der die IP-Headerkomprimierung nicht ordnungsgemäß aushandelt. |
|
Wenn dieses Flag festgelegt ist, erfolgt die Standardroute für IP-Pakete über den DFÜ-Adapter, wenn die Verbindung aktiv ist. Wenn dieses Flag gelöscht wird, wird die Standardroute nicht geändert.
Dieses Flag entspricht dem Kontrollkästchen Standardgateway im Remotenetzwerk verwenden im Dialogfeld TCP/IP-Einstellungen . |
|
Wenn dieses Flag festgelegt ist, deaktiviert RRAS die in RFC 1570 definierten PPP-LCP-Erweiterungen. Das Deaktivieren der PPP-LCP-Erweiterungen kann erforderlich sein, um eine Verbindung mit bestimmten älteren PPP-Implementierungen herzustellen, beeinträchtigt jedoch Features wie z. B. Serverrückruf. Legen Sie dieses Flag nicht fest, es sei denn, es ist ausdrücklich erforderlich. |
|
Wenn dieses Flag festgelegt ist, wird die Softwarekomprimierung über den Link ausgehandelt. Das Festlegen dieses Flags führt dazu, dass der PPP-Treiber versucht, das Compression Control Protocol (CCP) mit dem Server auszuhandeln. Dieses Flag sollte standardmäßig festgelegt werden, aber das Löschen kann den Aushandlungszeitraum verkürzen, wenn der Server kein kompatibles Komprimierungsprotokoll unterstützt. |
|
Wenn dieses Flag festgelegt ist, können nur sichere Kennwortschemas verwendet werden, um den Client beim Server zu authentifizieren. Dadurch wird verhindert, dass der PPP-Treiber das PAP-Nur-Text-Authentifizierungsprotokoll zur Authentifizierung des Clients verwendet. Die Authentifizierungsprotokolle MS-CHAP, MD5-CHAP und SPAP werden jedoch unterstützt. Um die Sicherheit zu erhöhen, legen Sie dieses Flag fest. Um die Interoperabilität zu erhöhen, deaktivieren Sie dieses Flag.
Dieses Flag entspricht dem Kontrollkästchen Verschlüsseltes Kennwort erforderlich im Dialogfeld Sicherheit . Weitere Informationen finden Sie unter MPRIO_RequireMsEncryptedPw. |
|
Wenn dieses Flag festgelegt ist, können nur die Sicheren Kennwortschemas von Microsoft verwendet werden, um den Client beim Server zu authentifizieren. Dadurch wird verhindert, dass der PPP-Treiber das PAP-Klartextauthentifizierungsprotokoll, MD5-CHAP oder SPAP verwendet. Um die Sicherheit zu erhöhen, legen Sie dieses Flag fest. Um die Interoperabilität zu erhöhen, deaktivieren Sie dieses Flag. Dieses Flag hat Vorrang vor MPRIO_RequireEncryptedPw.
Dieses Flag entspricht dem Kontrollkästchen Microsoft Encrypted Password erforderlich im Dialogfeld Sicherheit . Weitere Informationen finden Sie unter MPRIO_RequireDataEncryption. |
|
Wenn dieses Flag festgelegt ist, muss die Datenverschlüsselung erfolgreich ausgehandelt werden, oder die Verbindung sollte abgebrochen werden. Dieses Flag wird ignoriert, es sei denn , MPRIO_RequireMsEncryptedPw ebenfalls festgelegt ist.
Dieses Flag entspricht dem Kontrollkästchen Datenverschlüsselung erforderlich im Dialogfeld Sicherheit . |
|
Dieses Flag ist für die zukünftige Verwendung reserviert. |
|
Wenn dieses Flag festgelegt ist, verwendet RRAS beim Wählen dieses Eintrags den Benutzernamen, das Kennwort und die Domäne des aktuell angemeldeten Benutzers. Dieses Flag wird ignoriert, es sei denn , MPRIO_RequireMsEncryptedPw ebenfalls festgelegt ist.
Diese Einstellung wird von der RasDial-Funktion ignoriert, bei der das Angeben leerer Zeichenfolgen für die Member szUserName und szPassword der RASDIALPARAMS-Struktur das gleiche Ergebnis liefert. Dieses Flag entspricht dem Kontrollkästchen Aktuellen Benutzernamen und Kennwort verwenden im Dialogfeld Sicherheit . |
|
Dieses Flag wirkt sich aus, wenn alternative Telefonnummern durch das szAlternates-Element definiert werden. Wenn dieses Flag festgelegt ist, wird eine alternative Telefonnummer, die erfolgreich eine Verbindung herstellt, zur primären Telefonnummer, und die aktuelle primäre Telefonnummer wird in die alternative Liste verschoben.
Dieses Flag entspricht dem Kontrollkästchen im Dialogfeld Alternative Zahlen . |
|
Wenn dieses Flag festgelegt ist, überprüft RRAS auf vorhandene Remotedateisystem- und Remotedruckerbindungen, bevor eine Verbindung mit diesem Eintrag hergestellt wird. In der Regel legen Sie dieses Flag für Telefonbucheinträge für öffentliche Netzwerke fest, um Benutzer daran zu erinnern, verbindungen mit ihrem privaten Netzwerk zu unterbrechen, bevor sie eine Verbindung mit einem öffentlichen Netzwerk herstellen. |
|
Wenn dieses Flag festgelegt ist, muss das Extensible Authentication Protocol (EAP) für die Authentifizierung unterstützt werden. |
|
Wenn dieses Flag festgelegt ist, muss das Kennwortauthentifizierungsprotokoll für die Authentifizierung unterstützt werden. |
|
Wenn dieses Flag festgelegt ist, muss das Kennwortauthentifizierungsprotokoll (SPAP) von Shiva für die Authentifizierung unterstützt werden. |
|
Wenn dieses Flag festgelegt ist, werden Telefonnummern freigegeben. |
|
Wenn dieses Flag festgelegt ist, muss das Challenge Handshake Authentication-Protokoll für die Authentifizierung unterstützt werden. |
|
Wenn dieses Flag festgelegt ist, muss das Microsoft Challenge Handshake Authentication-Protokoll für die Authentifizierung unterstützt werden. |
|
Wenn dieses Flag festgelegt ist, muss Version 2 des Microsoft Challenge Handshake Authentication-Protokolls für die Authentifizierung unterstützt werden. |
szLocalPhoneNumber[RAS_MaxPhoneNumber + 1]
Ein -Wert, der eine NULL-endende Zeichenfolge angibt, die eine Telefonnummer oder eine IPv6-Adresse enthält.
szAlternates
Ein Zeiger auf eine Liste von aufeinanderfolgenden Unicode-Zeichenfolgen mit Null-Ende. Die letzte Zeichenfolge wird durch zwei aufeinanderfolgende NULL-Zeichen beendet. Die Zeichenfolgen sind alternative Telefonnummern, die der Router in der angegebenen Reihenfolge wählt, wenn die primäre Nummer keine Verbindung herstellen kann. Weitere Informationen finden Sie unter szLocalPhoneNumber.
ipaddr
Ein -Wert, der die IP-Adresse angibt, die verwendet werden soll, während diese Verbindung aktiv ist. Dieser Member wird ignoriert, es sei denn , dwfOptions gibt das flag MPRIO_SpecificIpAddr an.
ipaddrDns
Ein -Wert, der die IP-Adresse des DNS-Servers angibt, der verwendet werden soll, während diese Verbindung aktiv ist. Dieser Member wird ignoriert, es sei denn , dwfOptions gibt das flag MPRIO_SpecificNameServers an.
ipaddrDnsAlt
Ein -Wert, der die IP-Adresse eines sekundären ODER Sicherungs-DNS-Servers angibt, der verwendet werden soll, während diese Verbindung aktiv ist. Dieser Member wird ignoriert, es sei denn , dwfOptions gibt das flag MPRIO_SpecificNameServers an.
ipaddrWins
Ein -Wert, der die IP-Adresse des WINS-Servers angibt, der verwendet werden soll, während diese Verbindung aktiv ist. Dieser Member wird ignoriert, es sei denn , dwfOptions gibt das flag MPRIO_SpecificNameServers an.
ipaddrWinsAlt
Ein -Wert, der die IP-Adresse eines sekundären WINS-Servers angibt, der verwendet werden soll, während diese Verbindung aktiv ist. Dieser Member wird ignoriert, es sei denn , dwfOptions gibt das flag MPRIO_SpecificNameServers an.
dwfNetProtocols
Ein -Wert, der die auszuhandelnden Netzwerkprotokolle angibt. Dieser Member kann eine Kombination der folgenden Flags sein.
| Flag | Bedeutung |
|---|---|
|
Aushandeln des IPX-Protokolls. |
|
Aushandeln des TCP/IP-Protokolls. |
64-Bit-Windows: Das MPRNP_Ipx-Flag wird nicht unterstützt.
szDeviceType[MPR_MaxDeviceType + 1]
Ein -Wert, der eine NULL-endende Zeichenfolge angibt, die den RRAS-Gerätetyp angibt, auf den von szDeviceName verwiesen wird. Dieser Member kann eine der folgenden Zeichenfolgenkonstanten sein.
szDeviceName[MPR_MaxDeviceName + 1]
Enthält eine NULL-Zeichenfolge, die den Namen eines TAPI-Geräts enthält, das mit diesem Telefonbucheintrag verwendet werden soll, z. B. "Fabrikam Inc 28800 External". Verwenden Sie die RasEnumDevices-Funktion , um alle verfügbaren RAS-fähigen Geräte aufzulisten.
szX25PadType[MPR_MaxPadType + 1]
Ein Datentyp, der eine NULL-endende Zeichenfolge enthält, die den X.25-PAD-Typ identifiziert. Legen Sie diesen Member auf eine leere Zeichenfolge ("") fest, es sei denn, der Eintrag sollte mit einem X.25-PAD wählen.
Windows 2000 und Windows NT: Die szX25PadType-Zeichenfolge wird einem Abschnittsnamen in PAD.INF zugeordnet.
szX25Address[MPR_MaxX25Address + 1]
Enthält eine NULL-endende Zeichenfolge, die die X.25-Adresse identifiziert, mit der eine Verbindung hergestellt werden soll. Legen Sie diesen Member auf eine leere Zeichenfolge ("") fest, es sei denn, der Eintrag sollte mit einem X.25 PAD oder einem nativen X.25-Gerät wählen.
szX25Facilities[MPR_MaxFacilities + 1]
Enthält eine NULL-Zeichenfolge, die die Einrichtungen angibt, die zum Zeitpunkt der Verbindung vom X.25-Host angefordert werden sollen. Dieser Member wird ignoriert, wenn szX25Address eine leere Zeichenfolge ("") ist.
szX25UserData[MPR_MaxUserData + 1]
Enthält eine NULL-endende Zeichenfolge, die zusätzliche Verbindungsdaten angibt, die zum Zeitpunkt der Verbindung für den X.25-Host bereitgestellt werden. Dieser Member wird ignoriert, wenn szX25Address eine leere Zeichenfolge ("") ist.
dwChannels
Für die zukünftige Verwendung reserviert.
dwSubEntries
Ein -Wert, der die Anzahl der diesem Eintrag zugeordneten Multilinkunterinstanzen angibt. Legen Sie beim Aufrufen von RasSetEntryProperties diesen Member auf Null fest. Verwenden Sie die RasSetSubEntryProperties-Funktion , um einem Telefonbucheintrag Unternamen hinzuzufügen.
dwDialMode
Gibt an, ob RRAS alle Multilink-Unternamen dieses Eintrags wählen soll, wenn der Eintrag zum ersten Mal verbunden ist. Dieser Member kann einer der folgenden Werte sein.
dwDialExtraPercent
Ein -Wert, der den Prozentsatz der Gesamtbandbreite angibt, die von den derzeit verbundenen Untergeordneten verfügbar ist. RRAS wählt einen zusätzlichen Unterversuch, wenn die verwendete Gesamtbandbreite dwDialExtraPercent Prozent der verfügbaren Bandbreite für mindestens dwDialExtraSampleSeconds Sekunden überschreitet.
Dieser Member wird ignoriert, es sei denn, das dwDialMode-Element gibt das flag MPRDM_DialAsNeeded an.
dwDialExtraSampleSeconds
Ein -Wert, der die Zeit in Sekunden angibt, für die die aktuelle Bandbreitennutzung den von dwDialExtraPercent angegebenen Schwellenwert überschreiten muss, bevor RRAS einen zusätzlichen Untereintrag wählt.
Dieser Member wird ignoriert, es sei denn, das dwDialMode-Element gibt das flag MPRDM_DialAsNeeded an.
dwHangUpExtraPercent
Ein -Wert, der den Prozentsatz der Gesamtbandbreite angibt, die von den derzeit verbundenen Untergeordneten verfügbar ist. RRAS beendet (hängt) eine vorhandene Unterversuchsverbindung ab, wenn die verwendete Gesamtbandbreite kleiner als dwHangUpExtraPercent Prozent der verfügbaren Bandbreite für mindestens dwHangUpExtraSampleSeconds Sekunden ist.
Dieser Member wird ignoriert, es sei denn, das dwDialMode-Element gibt das flag MPRDM_DialAsNeeded an.
dwHangUpExtraSampleSeconds
Ein -Wert, der die Zeit in Sekunden angibt, für die die aktuelle Bandbreitennutzung kleiner als der von dwHangUpExtraPercent angegebene Schwellenwert sein muss, bevor RRAS eine vorhandene Unterversuchsverbindung beendet.
Dieser Member wird ignoriert, es sei denn, das dwDialMode-Element gibt das flag MPRDM_DialAsNeeded an.
dwIdleDisconnectSeconds
Ein -Wert, der die Zeit in Sekunden angibt, nach der eine inaktive Verbindung beendet wird. Sofern das Leerlauftimeout nicht deaktiviert ist, wird die gesamte Verbindung beendet, wenn sich die Verbindung für das angegebene Intervall im Leerlauf befindet. Dieses Element kann entweder einen Timeoutwert oder einen der folgenden Werte angeben.
| Wert | Bedeutung |
|---|---|
|
Es gibt kein Leerlauftimeout für diese Verbindung. |
|
Verwenden Sie den Wert für die Benutzereinstellung als Standardeinstellung. |
dwType
Ein -Wert, der den Typ des Telefonbucheintrags angibt. Dieser Member kann einer der folgenden Typen sein.
| type | Bedeutung |
|---|---|
|
Telefonleitung, z. B. Modem, ISDN oder X.25. |
|
Virtuelles privates Netzwerk. |
|
Direkte serielle oder parallele Verbindung. |
dwEncryptionType
Ein -Wert, der den Verschlüsselungstyp angibt, der für Microsoft Point-to-Point-Verschlüsselung (MPPE) mit der Verbindung verwendet werden soll. Dieser Member kann einer der folgenden Werte sein.
Der Wert von dwEncryptionType wirkt sich nicht darauf aus, wie Kennwörter verschlüsselt werden. Ob Kennwörter verschlüsselt sind und wie Kennwörter verschlüsselt werden, wird durch das Authentifizierungsprotokoll bestimmt, z. B. PAP, MS-CHAP oder EAP.
dwCustomAuthKey
Ein -Wert, der den Authentifizierungsschlüssel angibt, der einem EAP-Anbieter (Extensible Authentication Protocol) zur Verfügung gestellt werden soll.
dwCustomAuthDataSize
Ein -Wert, der die Größe der Daten angibt, auf die das lpbCustomAuthData-Element verweist.
lpbCustomAuthData
Ein Zeiger auf Authentifizierungsdaten, die mit EAP verwendet werden sollen.
guidId
Die GUID (Globally Unique Identifier), die diesen Telefonbucheintrag darstellt. Dieser Member ist schreibgeschützt.
dwVpnStrategy
Die VPN-Strategie, die beim Wählen einer VPN-Verbindung verwendet werden soll. Dieser Member kann über einen der folgenden Werte verfügen.
AddressCount
Wird nicht verwendet.
ipv6addrDns
Ein -Wert, der die IP-Adresse des DNS-Servers angibt, der verwendet werden soll, während diese Verbindung aktiv ist.
ipv6addrDnsAlt
Ein -Wert, der die IP-Adresse eines sekundären ODER Sicherungs-DNS-Servers angibt, der verwendet werden soll, während diese Verbindung aktiv ist.
ipv6addr
Wird nicht verwendet.
Bemerkungen
Die MPR_INTERFACE_3-Struktur verfügt über eine Anzahl von Membern, die Den Elementen der RASENTRY-Struktur ähneln.
Die folgenden Member aus der RASENTRY-Struktur haben keine Entsprechung in MPR_INTERFACE_3:
- dwCountryID
- dwCountryCode
- szAreaCode
- dwFramingProtocol
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | mprapi.h |