MPR_INTERFACE_2-Struktur (mprapi.h)
Die MPR_INTERFACE_2-Struktur enthält Daten für eine Router-Bedarfswählschnittstelle.
Syntax
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;
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 möglicher Werte finden Sie unter Gründe für die Nichterreichbarkeit.
dwLastError
Ein Wert, der einen ungleichen Wert 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 flags festlegen, die in der folgenden Tabelle aufgeführt sind.
| 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 Deaktivieren 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 in der Netzwerksteuerung festgelegte IP-Adresse. |
|
Wenn dieses Flag festgelegt ist, verwendet RRAS die Mitglieder 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 Nameserveradressen angeben im Dialogfeld TCP/IP-Einstellungen. Das Löschen des MPRIO_SpecificNameServers Flags entspricht der Auswahl der Einstellung Server zugewiesene Servernamenadressen im Dialogfeld TCP/IP-Einstellungen . |
|
Wenn dieses Flag festgelegt ist, verhandelt RRAS, 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 gelöscht 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 deaktiviert ist, 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 ist möglicherweise erforderlich, um eine Verbindung mit bestimmten älteren PPP-Implementierungen herzustellen, beeinträchtigt jedoch Features wie Serverrückruf. Legen Sie dieses Flag nur dann fest, wenn es ausdrücklich erforderlich ist. |
|
Wenn dieses Flag festgelegt ist, wird die Softwarekomprimierung für 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-Klartextauthentifizierungsprotokoll verwendet, um den Client zu authentifizieren. 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 anfordern 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 gelöscht werden. Dieses Flag wird ignoriert, es sei denn , MPRIO_RequireMsEncryptedPw wird ebenfalls festgelegt.
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 wird ebenfalls festgelegt.
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 vom 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 Protocol 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. |
|
Wenn dieses Flag für dwfOptions in der MPR_INTERFACE_2-Struktur festgelegt und in MprAdminInterfaceSetInfo verwendet wird, konfiguriert es die Bedarfswählschnittstelle für die Verwendung des vorab freigegebenen Schlüssels. |
|
Windows 8 oder höher: Wenn dieses Flag festgelegt ist, werden Computerzertifikate für die IKEv2-Authentifizierung verwendet. |
|
Windows 8 oder höher: Wenn dieses Flag festgelegt ist, wird ein vorab freigegebener Schlüssel vom Initiator der IKEv2-Verbindung für die Authentifizierung verwendet. |
|
Windows 8 oder höher: Wenn dieses Flag festgelegt ist, wird ein vorab freigegebener Schlüssel vom Antwortgeber der IKEv2-Verbindung für die Authentifizierung verwendet. |
szLocalPhoneNumber[RAS_MaxPhoneNumber + 1]
Ein Wert, der eine NULL-beendete Zeichenfolge angibt, die eine Telefonnummer enthält.
szAlternates
Ein Zeiger auf eine Liste von aufeinanderfolgenden Unicode-Zeichenfolgen mit NULL-Beendigung. Die letzte Zeichenfolge wird durch zwei aufeinanderfolgende NULL-Zeichen beendet. Die Zeichenfolgen sind alternative Telefonnummern, die der Router in der aufgeführten 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. Dieses Element 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, wenn 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 DNS-Servers oder eines 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 |
|---|---|
|
Verhandeln Sie das IPX-Protokoll. |
|
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-beendete Zeichenfolge angibt, die den RRAS-Gerätetyp angibt, auf den von szDeviceName verwiesen wird. Bei diesem Member kann es sich um eine der folgenden Zeichenfolgenkonstanten handeln.
szDeviceName[MPR_MaxDeviceName + 1]
Enthält eine NULL-beendete Zeichenfolge, die den Namen eines TAPI-Geräts enthält, das mit diesem Telefonbucheintrag verwendet werden soll, z. B. "Fabrikam Inc 28800 External". Um alle verfügbaren RAS-fähigen Geräte aufzulisten, verwenden Sie die RasEnumDevices-Funktion .
szX25PadType[MPR_MaxPadType + 1]
Ein Datentyp, der eine NULL-beendete 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-Zeichenfolge, die die X.25-Adresse identifiziert, mit der eine Verbindung hergestellt werden soll. Legen Sie dieses Element auf eine leere Zeichenfolge ("") fest, es sei denn, der Eintrag sollte sich mit einem X.25-PAD oder einem nativen X.25-Gerät wählen.
szX25Facilities[MPR_MaxFacilities + 1]
Enthält eine NULL-beendete Zeichenfolge, die die Einrichtungen angibt, die vom X.25-Host zur Verbindungszeit anzufordern sind. Dieses Element wird ignoriert, wenn szX25Address eine leere Zeichenfolge ("") ist.
szX25UserData[MPR_MaxUserData + 1]
Enthält eine NULL-beendete Zeichenfolge, die zusätzliche Verbindungsdaten angibt, die zum Zeitpunkt der Verbindung an den X.25-Host bereitgestellt werden. Dieses Element wird ignoriert, wenn szX25Address eine leere Zeichenfolge ("") ist.
dwChannels
Für die zukünftige Verwendung reserviert.
dwSubEntries
Ein -Wert, der die Anzahl der multilink-Unterriesen angibt, die diesem Eintrag zugeordnet sind. Legen Sie beim Aufrufen von RasSetEntryProperties diesen Member auf 0 fest. Um einem Telefonbucheintrag Untereinträge hinzuzufügen, verwenden Sie die RasSetSubEntryProperties-Funktion .
dwDialMode
Gibt an, ob RRAS alle Multilinkunterriesen 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 aktuell verbundenen Unterriesen verfügbar ist. RRAS wählt einen zusätzlichen Untereintrag, 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 aktuell verbundenen Unterriesen verfügbar ist. RRAS beendet (hängt) eine vorhandene Untereintragsverbindung 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 unter dem schwellenwert liegen muss, der von dwHangUpExtraPercent angegeben wird, bevor RRAS eine vorhandene Untertryverbindung 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. Dieser Member 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.
Hinweise
Die MPR_INTERFACE_2-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_2:
- 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 |