structure MPR_INTERFACE_3 (mprapi.h)
La structure MPR_INTERFACE_3 contient des données pour une interface de numérotation à la demande de routeur.
Syntaxe
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;
Membres
wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]
Pointeur vers une chaîne Unicode qui contient le nom de l’interface.
hInterface
Handle de l’interface.
fEnabled
Valeur qui spécifie si l’interface est activée. Cette valeur est TRUE si l’interface est activée et FALSE si l’interface est désactivée administrativement.
dwIfType
Valeur qui identifie le type d’interface.
dwConnectionState
Valeur qui décrit l’état actuel de l’interface, par exemple, connectée, déconnectée ou inaccessible. Pour plus d’informations et une liste des états possibles, consultez ROUTER_CONNECTION_STATE.
fUnReachabilityReasons
Valeur qui décrit la raison pour laquelle l’interface est inaccessible. Pour plus d’informations et pour obtenir la liste des valeurs possibles, consultez Raisons de l’inexéibilité.
dwLastError
Valeur qui contient une valeur différente de zéro si l’interface ne parvient pas à se connecter.
dwfOptions
Valeur qui spécifie les indicateurs de bits utilisés pour définir les options de connexion. Vous pouvez définir l’un des indicateurs répertoriés dans le tableau suivant.
| Indicateur | Signification |
|---|---|
|
Si cet indicateur est défini, RRAS tente d’utiliser l’adresse IP spécifiée par ipaddr comme adresse IP pour la connexion d’accès à distance. Si cet indicateur n’est pas défini, la valeur du membre ipaddr est ignorée.
La définition de l’indicateur MPRIO_SpecificIpAddr correspond à la sélection du paramètre Spécifier une adresse IP dans la boîte de dialogue Paramètres TCP/IP. L’effacement de l’indicateur MPRIO_SpecificIpAddr correspond à la sélection du paramètre Adresse IP affectée par le serveur dans la boîte de dialogue Paramètres TCP/IP . Actuellement, une adresse IP définie dans les propriétés d’entrée de l’annuaire téléphonique ou récupérée à partir d’un serveur remplace l’adresse IP définie dans le panneau de configuration réseau. |
|
Si cet indicateur est défini, RRAS utilise les membres ipaddrDns, ipaddrDnsAlt, ipaddrWins et ipaddrWinsAlt pour spécifier les adresses du serveur de noms pour la connexion d’accès à distance. Si cet indicateur n’est pas défini, RRAS ignore ces membres.
La définition de l’indicateur MPRIO_SpecificNameServers correspond à la sélection du paramètre Spécifier les adresses du serveur de noms dans la boîte de dialogue Paramètres TCP/IP. L’effacement de l’indicateur de MPRIO_SpecificNameServers correspond à la sélection du paramètre Server Assigned Name Server Addresses dans la boîte de dialogue Paramètres TCP/IP . |
|
Si cet indicateur est défini, RRAS négocie l’utilisation de la compression d’en-tête IP sur les connexions PPP. La compression de l’en-tête IP peut améliorer considérablement les performances.
Si cet indicateur n’est pas défini, la compression de l’en-tête IP n’est pas négociée. Cet indicateur correspond à la zone Utiliser la compression d’en-tête IP case activée de la boîte de dialogue Paramètres TCP/IP. L’indicateur doit être effacé uniquement lors de la connexion à un serveur qui ne négocie pas correctement la compression d’en-tête IP. |
|
Si cet indicateur est défini, l’itinéraire par défaut des paquets IP passe par l’adaptateur d’accès à distance lorsque la connexion est active. Si cet indicateur est effacé, l’itinéraire par défaut n’est pas modifié.
Cet indicateur correspond à la zone Utiliser la passerelle par défaut sur le réseau distant case activée de la boîte de dialogue Paramètres TCP/IP. |
|
Si cet indicateur est défini, RRAS désactive les extensions PPP LCP définies dans RFC 1570. La désactivation des extensions PPP LCP peut être nécessaire pour se connecter à certaines implémentations PPP plus anciennes, mais elle interfère avec des fonctionnalités telles que le rappel de serveur. Ne définissez pas cet indicateur, sauf s’il est spécifiquement requis. |
|
Si cet indicateur est défini, la compression logicielle est négociée sur le lien. Si vous définissez cet indicateur, le pilote PPP tente de négocier le protocole CCP (Compression Control Protocol) avec le serveur. Cet indicateur doit être défini par défaut, mais son effacement peut réduire la période de négociation si le serveur ne prend pas en charge un protocole de compression compatible. |
|
Si cet indicateur est défini, seuls les schémas de mot de passe sécurisés peuvent être utilisés pour authentifier le client auprès du serveur. Cela empêche le pilote PPP d’utiliser le protocole d’authentification en texte brut PAP pour authentifier le client. Toutefois, les protocoles d’authentification MS-CHAP, MD5-CHAP et SPAP sont pris en charge. Pour plus de sécurité, définissez cet indicateur. Pour une interopérabilité accrue, effacez cet indicateur.
Cet indicateur correspond à la zone Exiger le mot de passe chiffré case activée de la boîte de dialogue Sécurité. Pour plus d’informations, consultez MPRIO_RequireMsEncryptedPw. |
|
Si cet indicateur est défini, seuls les schémas de mot de passe sécurisés Microsoft peuvent être utilisés pour authentifier le client auprès du serveur. Cela empêche le pilote PPP d’utiliser le protocole d’authentification en texte brut PAP, MD5-CHAP ou SPAP. Pour plus de sécurité, définissez cet indicateur. Pour une interopérabilité accrue, effacez cet indicateur. Cet indicateur est prioritaire sur MPRIO_RequireEncryptedPw.
Cet indicateur correspond à la zone Exiger le case activée de mot de passe chiffré Microsoft dans la boîte de dialogue Sécurité. Pour plus d’informations, consultez MPRIO_RequireDataEncryption. |
|
Si cet indicateur est défini, le chiffrement des données doit être négocié correctement ou la connexion doit être supprimée. Cet indicateur est ignoré, sauf si MPRIO_RequireMsEncryptedPw est également défini.
Cet indicateur correspond à la zone Exiger le chiffrement des données case activée de la boîte de dialogue Sécurité. |
|
Cet indicateur est réservé pour une utilisation future. |
|
Si cet indicateur est défini, RRAS utilise le nom d’utilisateur, le mot de passe et le domaine de l’utilisateur actuellement connecté lors de la numérotation de cette entrée. Cet indicateur est ignoré, sauf si MPRIO_RequireMsEncryptedPw est également défini.
Ce paramètre est ignoré par la fonction RasDial où la spécification de chaînes vides pour les membres szUserName et szPassword de la structure RASDIALPARAMS fournit le même résultat. Cet indicateur correspond à la zone Utiliser le nom d’utilisateur et le mot de passe actuel case activée de la boîte de dialogue Sécurité. |
|
Cet indicateur a un effet lorsque d’autres numéros de téléphone sont définis par le membre szAlternates . Si cet indicateur est défini, un autre numéro de téléphone qui se connecte correctement devient le numéro de téléphone principal et le numéro de téléphone principal actuel est déplacé vers la liste secondaire.
Cet indicateur correspond à la zone case activée de la boîte de dialogue Numéros de remplacement. |
|
Si cet indicateur est défini, RRAS recherche le système de fichiers distant et les liaisons d’imprimante distantes existantes avant d’établir une connexion avec cette entrée. En règle générale, vous définissez cet indicateur sur les entrées d’annuaire téléphonique pour les réseaux publics afin de rappeler aux utilisateurs d’interrompre les connexions à leur réseau privé avant de se connecter à un réseau public. |
|
Si cet indicateur est défini, le protocole EAP (Extensible Authentication Protocol) doit être pris en charge pour l’authentification. |
|
Si cet indicateur est défini, le protocole d’authentification par mot de passe doit être pris en charge pour l’authentification. |
|
Si cet indicateur est défini, le protocole SPAP (Password Authentication Protocol) de Shiva doit être pris en charge pour l’authentification. |
|
Si cet indicateur est défini, les numéros de téléphone sont partagés. |
|
Si cet indicateur est défini, le protocole d’authentification Challenge Handshake doit être pris en charge pour l’authentification. |
|
Si cet indicateur est défini, le protocole d’authentification Microsoft Challenge Handshake doit être pris en charge pour l’authentification. |
|
Si cet indicateur est défini, la version 2 du protocole d’authentification Microsoft Challenge Handshake doit être prise en charge pour l’authentification. |
szLocalPhoneNumber[RAS_MaxPhoneNumber + 1]
Valeur qui spécifie une chaîne terminée par null qui contient un numéro de téléphone ou une adresse IPv6.
szAlternates
Pointeur vers une liste de chaînes Unicode terminées par un caractère Null consécutif. La dernière chaîne est terminée par deux caractères null consécutifs. Les chaînes sont d’autres numéros de téléphone que le routeur compose, dans l’ordre indiqué, si le numéro principal ne parvient pas à se connecter. Pour plus d’informations, consultez szLocalPhoneNumber.
ipaddr
Valeur qui spécifie l’adresse IP à utiliser pendant que cette connexion est active. Ce membre est ignoré, sauf si dwfOptions spécifie l’indicateur MPRIO_SpecificIpAddr .
ipaddrDns
Valeur qui spécifie l’adresse IP du serveur DNS à utiliser pendant que cette connexion est active. Ce membre est ignoré, sauf si dwfOptions spécifie l’indicateur MPRIO_SpecificNameServers .
ipaddrDnsAlt
Valeur qui spécifie l’adresse IP d’un serveur DNS secondaire ou de sauvegarde à utiliser pendant que cette connexion est active. Ce membre est ignoré, sauf si dwfOptions spécifie l’indicateur MPRIO_SpecificNameServers .
ipaddrWins
Valeur qui spécifie l’adresse IP du serveur WINS à utiliser pendant que cette connexion est active. Ce membre est ignoré, sauf si dwfOptions spécifie l’indicateur MPRIO_SpecificNameServers .
ipaddrWinsAlt
Valeur qui spécifie l’adresse IP d’un serveur WINS secondaire à utiliser pendant que cette connexion est active. Ce membre est ignoré, sauf si dwfOptions spécifie l’indicateur MPRIO_SpecificNameServers .
dwfNetProtocols
Valeur qui spécifie les protocoles réseau à négocier. Ce membre peut être une combinaison des indicateurs suivants.
| Indicateur | Signification |
|---|---|
|
Négocier le protocole IPX. |
|
Négocier le protocole TCP/IP. |
Windows 64 bits : L’indicateur MPRNP_Ipx n’est pas pris en charge
szDeviceType[MPR_MaxDeviceType + 1]
Valeur qui spécifie une chaîne terminée par null qui indique le type d’appareil RRAS référencé par szDeviceName. Ce membre peut être l’une des constantes de chaîne suivantes.
szDeviceName[MPR_MaxDeviceName + 1]
Contient une chaîne terminée par null qui contient le nom d’un appareil TAPI à utiliser avec cette entrée de carnet de téléphone, par exemple, « Fabrikam Inc 28800 External ». Pour énumérer tous les appareils ras disponibles, utilisez la fonction RasEnumDevices .
szX25PadType[MPR_MaxPadType + 1]
Type de données qui contient une chaîne terminée par null qui identifie le type PAD X.25. Définissez ce membre sur une chaîne vide (« ») sauf si l’entrée doit composer à l’aide d’un PAD X.25.
Windows 2000 et Windows NT : La chaîne szX25PadType est mappée à un nom de section dans PAD.INF.
szX25Address[MPR_MaxX25Address + 1]
Contient une chaîne terminée par null qui identifie l’adresse X.25 à laquelle se connecter. Définissez ce membre sur une chaîne vide (« ») sauf si l’entrée doit composer à l’aide d’un pad X.25 ou d’un appareil X.25 natif.
szX25Facilities[MPR_MaxFacilities + 1]
Contient une chaîne terminée par null qui spécifie les fonctionnalités à demander à l’hôte X.25 au moment de la connexion. Ce membre est ignoré si szX25Address est une chaîne vide (« »).
szX25UserData[MPR_MaxUserData + 1]
Contient une chaîne terminée par null qui spécifie des données de connexion supplémentaires fournies à l’hôte X.25 au moment de la connexion. Ce membre est ignoré si szX25Address est une chaîne vide (« »).
dwChannels
Réservé pour un usage futur.
dwSubEntries
Valeur qui spécifie le nombre de sous-entités à liaisons multiples associées à cette entrée. Lorsque vous appelez RasSetEntryProperties, définissez ce membre sur zéro. Pour ajouter des sous-entrées à une entrée de répertoire téléphonique, utilisez la fonction RasSetSubEntryProperties .
dwDialMode
Indique si RRAS doit composer toutes les sous-entités à liaisons multiples de cette entrée lorsque l’entrée est connectée pour la première fois. Ce membre peut être l’une des valeurs suivantes.
dwDialExtraPercent
Valeur qui spécifie le pourcentage de la bande passante totale disponible à partir des sous-entités actuellement connectées. RRAS compose une sous-entrée supplémentaire lorsque la bande passante totale utilisée dépasse dwDialExtraPercent % de la bande passante disponible pendant au moins dwDialExtraSampleSeconds secondes .
Ce membre est ignoré, sauf si le membre dwDialMode spécifie l’indicateur MPRDM_DialAsNeeded .
dwDialExtraSampleSeconds
Valeur qui spécifie la durée, en secondes, pendant laquelle l’utilisation actuelle de la bande passante doit dépasser le seuil spécifié par dwDialExtraPercent avant que RRAS compose une sous-entrée supplémentaire.
Ce membre est ignoré, sauf si le membre dwDialMode spécifie l’indicateur MPRDM_DialAsNeeded .
dwHangUpExtraPercent
Valeur qui spécifie le pourcentage de la bande passante totale disponible à partir des sous-entités actuellement connectées. RRAS termine (raccroche) une connexion de sous-entrée existante lorsque la bande passante totale utilisée est inférieure à dwHangUpExtraPercent % de la bande passante disponible pendant au moins dwHangUpExtraSampleSeconds secondes .
Ce membre est ignoré, sauf si le membre dwDialMode spécifie l’indicateur MPRDM_DialAsNeeded .
dwHangUpExtraSampleSeconds
Valeur qui spécifie la durée, en secondes, pendant laquelle l’utilisation actuelle de la bande passante doit être inférieure au seuil spécifié par dwHangUpExtraPercent avant que RRAS mette fin à une connexion de sous-entrée existante.
Ce membre est ignoré, sauf si le membre dwDialMode spécifie l’indicateur MPRDM_DialAsNeeded .
dwIdleDisconnectSeconds
Valeur qui spécifie la durée, en secondes, après laquelle une connexion inactive est terminée. Sauf si le délai d’inactivité est désactivé, la connexion entière est arrêtée si la connexion est inactive pendant l’intervalle spécifié. Ce membre peut spécifier une valeur de délai d’attente ou l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Il n’existe aucun délai d’inactivité pour cette connexion. |
|
Utilisez la valeur de préférence utilisateur comme valeur par défaut. |
dwType
Valeur qui spécifie le type d’entrée d’annuaire téléphonique. Ce membre peut être de l’un des types suivants.
| Type | Signification |
|---|---|
|
Ligne téléphonique, par exemple, modem, ISDN ou X.25. |
|
Réseau privé virtuel. |
|
Connexion directe en série ou parallèle. |
dwEncryptionType
Valeur qui spécifie le type de chiffrement à utiliser pour microsoft MPPE (Point à Point Encryption) avec la connexion. Ce membre peut être l’une des valeurs suivantes.
La valeur de dwEncryptionType n’affecte pas la façon dont les mots de passe sont chiffrés. Le chiffrement des mots de passe et le chiffrement des mots de passe sont déterminés par le protocole d’authentification, par exemple, PAP, MS-CHAP ou EAP.
dwCustomAuthKey
Valeur qui spécifie la clé d’authentification à fournir à un fournisseur EAP (Extensible Authentication Protocol).
dwCustomAuthDataSize
Valeur qui spécifie la taille des données pointées vers le membre lpbCustomAuthData .
lpbCustomAuthData
Pointeur vers les données d’authentification à utiliser avec EAP.
guidId
Identificateur global unique (GUID) qui représente cette entrée d’annuaire téléphonique. Ce membre est en lecture seule.
dwVpnStrategy
Stratégie VPN à utiliser lors de la numérotation d’une connexion VPN. Ce membre peut avoir l’une des valeurs suivantes.
AddressCount
Non utilisé.
ipv6addrDns
Valeur qui spécifie l’adresse IP du serveur DNS à utiliser pendant que cette connexion est active.
ipv6addrDnsAlt
Valeur qui spécifie l’adresse IP d’un serveur DNS secondaire ou de sauvegarde à utiliser pendant que cette connexion est active.
ipv6addr
Non utilisé.
Notes
La structure MPR_INTERFACE_3 a un certain nombre de membres qui sont similaires aux membres de la structure RASENTRY .
Les membres suivants de la structure RASENTRY n’ont pas d’équivalent dans MPR_INTERFACE_3 :
- dwCountryID
- dwCountryCode
- szAreaCode
- dwFramingProtocol
Spécifications
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | mprapi.h |