Partager via


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
MPRIO_SpecificIpAddr
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.

MPRIO_SpecificNameServers
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 .

MPRIO_IpHeaderCompression
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.

MPRIO_RemoteDefaultGateway
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.

MPRIO_DisableLcpExtensions
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.
MPRIO_SwCompression
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.
MPRIO_RequireEncryptedPw
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.

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.

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é.

MPRIO_NetworkLogon
Cet indicateur est réservé pour une utilisation future.
MPRIO_UseLogonCredentials
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é.

MPRIO_PromoteAlternates
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.

MPRIO_SecureLocalFiles
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.
MPRIO_RequireEAP
Si cet indicateur est défini, le protocole EAP (Extensible Authentication Protocol) doit être pris en charge pour l’authentification.
MPRIO_RequirePAP
Si cet indicateur est défini, le protocole d’authentification par mot de passe doit être pris en charge pour l’authentification.
MPRIO_RequireSPAP
Si cet indicateur est défini, le protocole SPAP (Password Authentication Protocol) de Shiva doit être pris en charge pour l’authentification.
MPRIO_SharedPhoneNumbers
Si cet indicateur est défini, les numéros de téléphone sont partagés.
MPRIO_RequireCHAP
Si cet indicateur est défini, le protocole d’authentification Challenge Handshake doit être pris en charge pour l’authentification.
MPRIO_RequireMsCHAP
Si cet indicateur est défini, le protocole d’authentification Microsoft Challenge Handshake doit être pris en charge pour l’authentification.
MPRIO_RequireMsCHAP2
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
MPRNP_Ipx
Négocier le protocole IPX.
MPRNP_Ip
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.

String Signification
MPRDT_Modem
Modem accessible via un port COM.
MPRDT_Isdn
Un adaptateur ISDN avec le pilote NDISWAN correspondant installé.
MPRDT_X25
Un adaptateur X.25 avec le pilote NDISWAN correspondant installé.
MPRDT_Vpn
Une connexion de réseau privé virtuel (VPN).
MPRDT_Pad
Assembleur/désassembleur de paquets.
MPRDT_Generic
Générique.
MPRDT_Serial
Connexion série directe via un port série.
MPRDT_FrameRelay
Relais de trame.
MPRDT_Atm
Mode de transfert asynchrone.
MPRDT_Sonet
Sonet.
MPRDT_SW56
56 Ko d’accès commuté.
MPRDT_Irda
Un appareil compatible IrDA (Infrared Data Association).
MPRDT_Parallel
Connexion parallèle directe via un port parallèle.

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.

Valeur Signification
MPRDM_DialAll
Composez initialement toutes les sous-entités.
MPRDM_DialAsNeeded
Ajustez le nombre de sous-entités en fonction de la bande passante requise. RRAS utilise les membres dwDialExtraPercent, dwDialExtraSampleSeconds, dwDialHangUpExtraPercent et dwHangUpExtraSampleSeconds pour déterminer quand composer ou déconnecter une sous-entrée.

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
MPRIDS_Disabled
Il n’existe aucun délai d’inactivité pour cette connexion.
MPRIDS_UseGlobalValue
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
MPRET_Phone
Ligne téléphonique, par exemple, modem, ISDN ou X.25.
MPRET_Vpn
Réseau privé virtuel.
MPRET_Direct
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.

Valeur Signification
MPR_ET_None
N’utilisez pas de chiffrement.
MPR_ET_Require
Utiliser le chiffrement.
MPR_ET_RequireMax
Utilisez le chiffrement à force maximale.
MPR_ET_Optional
Si possible, utilisez le chiffrement.
 

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.

Valeur Signification
MPR_VS_Default
RRAS appelle d’abord PPTP. Si PPTP échoue, L2TP est tenté. Le protocole qui réussit est essayé en premier lors de la numérotation suivante pour cette entrée.
MPR_VS_PptpOnly
RAS compose uniquement PPTP.
MPR_VS_PptpFirst
RAS compose toujours PPTP en premier, L2TP en second.
MPR_VS_L2tpOnly
Ras compose uniquement L2TP.
MPR_VS_L2tpFirst
RAS compose D’abord L2TP, PPTP deuxième.

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
Windows 64 bits : Ne prend pas en charge le protocole IPX.

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

Voir aussi

MPR_INTERFACE_0

MPR_INTERFACE_1

MPR_INTERFACE_2

MprAdminInterfaceGetInfo

MprAdminInterfaceSetInfo