estructura de MPR_INTERFACE_2 (mprapi.h)

Artículo
03/15/2023

La estructura de MPR_INTERFACE_2 contiene datos para una interfaz de marcado a petición del enrutador.

Sintaxis

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]

Puntero a una cadena Unicode que contiene el nombre de la interfaz.

hInterface

Identificador de la interfaz.

fEnabled

Valor que especifica si la interfaz está habilitada. Este valor es TRUE si la interfaz está habilitada, FALSE si la interfaz está deshabilitada administrativamente.

dwIfType

Valor que identifica el tipo de interfaz.

dwConnectionState

Valor que describe el estado actual de la interfaz, por ejemplo, conectado, desconectado o inaccesible. Para obtener más información y una lista de los posibles estados, consulte ROUTER_CONNECTION_STATE.

fUnReachabilityReasons

Valor que describe el motivo por el que no se puede acceder a la interfaz. Para obtener más información y una lista de valores posibles, vea Motivos de inalcanzabilidad.

dwLastError

Valor que contiene un valor distinto de cero si la interfaz no se puede conectar.

dwfOptions

Valor que especifica marcas de bits que se usan para establecer las opciones de conexión. Puede establecer una de las marcas enumeradas en la tabla siguiente.

Marca	Significado
MPRIO_SpecificIpAddr	Si se establece esta marca, RRAS intenta usar la dirección IP especificada por ipaddr como dirección IP para la conexión de acceso telefónico. Si no se establece esta marca, se omite el valor del miembro ipaddr . Establecer la marca de MPRIO_SpecificIpAddr corresponde a seleccionar la opción Especificar una dirección IP en el cuadro de diálogo Configuración de TCP/IP. Borrar la marca de MPRIO_SpecificIpAddr corresponde a seleccionar la opción Dirección IP asignada por el servidor en el cuadro de diálogo Configuración de TCP/IP . Actualmente, una dirección IP establecida en las propiedades de entrada de la libreta de teléfonos o recuperada de un servidor invalida el conjunto de direcciones IP en el panel de control de red.
MPRIO_SpecificNameServers	Si se establece esta marca, RRAS usa los miembros ipaddrDns, ipaddrDnsAlt, ipaddrWins y ipaddrWinsAlt para especificar las direcciones del servidor de nombres para la conexión de acceso telefónico. Si no se establece esta marca, RRAS omite estos miembros. Establecer la marca de MPRIO_SpecificNameServers corresponde a la opción Especificar direcciones del servidor de nombres en el cuadro de diálogo Configuración de TCP/IP. Borrar la marca de MPRIO_SpecificNameServers corresponde a seleccionar la opción Direcciones de servidor de nombres asignadas por el servidor en el cuadro de diálogo Configuración de TCP/IP .
MPRIO_IpHeaderCompression	Si se establece esta marca, RRAS negocia el uso de la compresión de encabezado IP en las conexiones PPP. La compresión de encabezado IP puede mejorar significativamente el rendimiento. Si no se establece esta marca, no se negocia la compresión de encabezado IP. Esta marca corresponde a la casilla Usar compresión de encabezado IP en el cuadro de diálogo Configuración de TCP/IP . La marca solo debe borrarse al conectarse a un servidor que no negocia correctamente la compresión del encabezado IP.
MPRIO_RemoteDefaultGateway	Si se establece esta marca, la ruta predeterminada para los paquetes IP es a través del adaptador de acceso telefónico cuando la conexión está activa. Si se borra esta marca, la ruta predeterminada no se modifica. Esta marca corresponde a la casilla Usar puerta de enlace predeterminada en red remota en el cuadro de diálogo Configuración de TCP/IP .
MPRIO_DisableLcpExtensions	Si se establece esta marca, RRAS deshabilita las extensiones LCP de PPP definidas en RFC 1570. La deshabilitación de las extensiones LCP de PPP puede ser necesaria para conectarse a determinadas implementaciones de PPP anteriores, pero interfiere con características como la devolución de llamada del servidor. No establezca esta marca a menos que se requiera específicamente.
MPRIO_SwCompression	Si se establece esta marca, la compresión de software se negocia en el vínculo. Al establecer esta marca, el controlador PPP intenta negociar el Protocolo de control de compresión (CCP) con el servidor. Esta marca debe establecerse de forma predeterminada, pero borrarla puede reducir el período de negociación si el servidor no admite un protocolo de compresión compatible.
MPRIO_RequireEncryptedPw	Si se establece esta marca, solo se pueden usar esquemas de contraseña seguros para autenticar al cliente con el servidor. Esto impide que el controlador PPP use el protocolo de autenticación de texto sin formato PAP para autenticar al cliente. Sin embargo, se admiten los protocolos de autenticación MS-CHAP, MD5-CHAP y SPAP. Para aumentar la seguridad, establezca esta marca. Para aumentar la interoperabilidad, desactive esta marca. Esta marca corresponde a la casilla Requerir contraseña cifrada en el cuadro de diálogo Seguridad . Para obtener más información, consulte MPRIO_RequireMsEncryptedPw.
MPRIO_RequireMsEncryptedPw	Si se establece esta marca, solo se pueden usar los esquemas de contraseña segura de Microsoft para autenticar al cliente con el servidor. Esto impide que el controlador PPP use el protocolo de autenticación de texto sin formato PAP, MD5-CHAP o SPAP. Para aumentar la seguridad, establezca esta marca. Para aumentar la interoperabilidad, desactive esta marca. Esta marca tiene prioridad sobre MPRIO_RequireEncryptedPw. Esta marca corresponde a la casilla Requerir contraseña cifrada de Microsoft en el cuadro de diálogo Seguridad . Para obtener más información, consulte MPRIO_RequireDataEncryption.
MPRIO_RequireDataEncryption	Si se establece esta marca, el cifrado de datos se debe negociar correctamente o se debe quitar la conexión. Esta marca se omite a menos que también se establezca MPRIO_RequireMsEncryptedPw. Esta marca corresponde a la casilla Requerir cifrado de datos en el cuadro de diálogo Seguridad .
MPRIO_NetworkLogon	Esta marca se reserva para uso futuro.
MPRIO_UseLogonCredentials	Si se establece esta marca, RRAS usa el nombre de usuario, la contraseña y el dominio del usuario que ha iniciado sesión actualmente al marcar esta entrada. Esta marca se omite a menos que también se establezca MPRIO_RequireMsEncryptedPw. Esta configuración se omite mediante la función RasDial donde la especificación de cadenas vacías para los miembros szUserName y szPassword de la estructura RASDIALPARAMS proporciona el mismo resultado. Esta marca corresponde a la casilla Usar nombre de usuario actual y contraseña en el cuadro de diálogo Seguridad .
MPRIO_PromoteAlternates	Esta marca tiene un efecto cuando el miembro szAlternates define números de teléfono alternativos. Si se establece esta marca, un número de teléfono alternativo que se conecta correctamente se convierte en el número de teléfono principal principal y el número de teléfono principal actual se mueve a la lista alternativa. Esta marca corresponde a la casilla del cuadro de diálogo Números alternativos .
MPRIO_SecureLocalFiles	Si se establece esta marca, RRAS comprueba si hay enlaces de impresora remota y del sistema de archivos remotos existentes antes de establecer una conexión con esta entrada. Normalmente, esta marca se establece en entradas de libreta de teléfonos para que las redes públicas recuerden a los usuarios que interrumpan las conexiones a su red privada antes de conectarse a una red pública.
MPRIO_RequireEAP	Si se establece esta marca, se debe admitir el Protocolo de autenticación extensible (EAP) para la autenticación.
MPRIO_RequirePAP	Si se establece esta marca, se debe admitir el protocolo de autenticación de contraseñas para la autenticación.
MPRIO_RequireSPAP	Si se establece esta marca, se debe admitir el Protocolo de autenticación de contraseña (SPAP) de Shiva para la autenticación.
MPRIO_SharedPhoneNumbers	Si se establece esta marca, se comparten los números de teléfono.
MPRIO_RequireCHAP	Si se establece esta marca, se debe admitir el Protocolo de autenticación de protocolo de enlace de desafío para la autenticación.
MPRIO_RequireMsCHAP	Si se establece esta marca, se debe admitir el protocolo de autenticación de protocolo de enlace de desafío de Microsoft para la autenticación.
MPRIO_RequireMsCHAP2	Si se establece esta marca, se debe admitir la versión 2 del protocolo de autenticación de protocolo de enlace de desafío de Microsoft para la autenticación.
MPRIO_IpSecPreSharedKey	Si esta marca se establece para dwfOptions en la estructura de MPR_INTERFACE_2 y se usa en MprAdminInterfaceSetInfo, configura la interfaz de marcado a petición para usar la clave precompartida.
MPRIO_RequireMachineCertificates	Windows 8 o posterior: si se establece esta marca, los certificados de máquina se usan para la autenticación IKEv2.
MPRIO_UsePreSharedKeyForIkev2Initiator	Windows 8 o posterior: si se establece esta marca, el iniciador de la conexión IKEv2 usa una clave previamente compartida para la autenticación.
MPRIO_UsePreSharedKeyForIkev2Responder	Windows 8 o posterior: si se establece esta marca, el respondedor de la conexión IKEv2 usa una clave previamente compartida para la autenticación.

szLocalPhoneNumber[RAS_MaxPhoneNumber + 1]

Valor que especifica una cadena terminada en null que contiene un número de teléfono.

szAlternates

Puntero a una lista de cadenas Unicode terminadas en null consecutivas. La última cadena finaliza con dos caracteres NULOs consecutivos. Las cadenas son números de teléfono alternativos que el enrutador marca, en el orden indicado, si el número principal no se puede conectar. Para obtener más información, vea szLocalPhoneNumber.

ipaddr

Valor que especifica la dirección IP que se va a usar mientras esta conexión está activa. Este miembro se omite a menos que dwfOptions especifique la marca de MPRIO_SpecificIpAddr .

ipaddrDns

Valor que especifica la dirección IP del servidor DNS que se va a usar mientras esta conexión está activa. Este miembro se omite a menos que dwfOptions especifique la marca MPRIO_SpecificNameServers .

ipaddrDnsAlt

Valor que especifica la dirección IP de un servidor DNS secundario o de copia de seguridad que se va a usar mientras esta conexión está activa. Este miembro se omite a menos que dwfOptions especifique la marca MPRIO_SpecificNameServers .

ipaddrWins

Valor que especifica la dirección IP del servidor WINS que se va a usar mientras esta conexión está activa. Este miembro se omite a menos que dwfOptions especifique la marca MPRIO_SpecificNameServers .

ipaddrWinsAlt

Valor que especifica la dirección IP de un servidor WINS secundario que se va a usar mientras esta conexión está activa. Este miembro se omite a menos que dwfOptions especifique la marca MPRIO_SpecificNameServers .

dwfNetProtocols

Valor que especifica los protocolos de red que se van a negociar. Este miembro puede ser una combinación de las marcas siguientes.

Marca	Significado
MPRNP_Ipx	Negociar el protocolo IPX.
MPRNP_Ip	Negociar el protocolo TCP/IP.

Windows de 64 bits: No se admite la marca MPRNP_Ipx

szDeviceType[MPR_MaxDeviceType + 1]

Valor que especifica una cadena terminada en null que indica el tipo de dispositivo RRAS al que hace referencia szDeviceName. Este miembro puede ser una de las siguientes constantes de cadena.

String	Significado
MPRDT_Modem	Módem al que se accede a través de un puerto COM.
MPRDT_Isdn	Un adaptador ISDN con el controlador NDISWAN correspondiente instalado.
MPRDT_X25	Un adaptador X.25 con el controlador NDISWAN correspondiente instalado.
MPRDT_Vpn	Una conexión de red privada virtual (VPN).
MPRDT_Pad	Ensamblador o desensamblador de paquetes.
MPRDT_Generic	Genérico.
MPRDT_Serial	Conexión serie directa a través de un puerto serie.
MPRDT_FrameRelay	Frame Relay.
MPRDT_Atm	Modo de transferencia asincrónica.
MPRDT_Sonet	Sonet.
MPRDT_SW56	Acceso 56K conmutado.
MPRDT_Irda	Un dispositivo compatible con la Asociación de datos infrarrojos (IrDA).
MPRDT_Parallel	Conexión paralela directa a través de un puerto paralelo.

szDeviceName[MPR_MaxDeviceName + 1]

Contiene una cadena terminada en null que contiene el nombre de un dispositivo TAPI que se usará con esta entrada de libreta de teléfonos, por ejemplo, "Fabrikam Inc 28800 External". Para enumerar todos los dispositivos compatibles con RAS disponibles, use la función RasEnumDevices .

szX25PadType[MPR_MaxPadType + 1]

Tipo de datos que contiene una cadena terminada en null que identifica el tipo PAD X.25. Establezca este miembro en una cadena vacía ("") a menos que la entrada deba marcar con un PAD X.25.

Windows 2000 y Windows NT: La cadena szX25PadType se asigna a un nombre de sección en PAD.INF.

szX25Address[MPR_MaxX25Address + 1]

Contiene una cadena terminada en null que identifica la dirección X.25 a la que se va a conectar. Establezca este miembro en una cadena vacía ("") a menos que la entrada deba marcar con un PAD X.25 o un dispositivo X.25 nativo.

szX25Facilities[MPR_MaxFacilities + 1]

Contiene una cadena terminada en null que especifica las instalaciones que se van a solicitar desde el host X.25 en el momento de la conexión. Este miembro se omite si szX25Address es una cadena vacía ("").

szX25UserData[MPR_MaxUserData + 1]

Contiene una cadena terminada en null que especifica datos de conexión adicionales proporcionados al host X.25 en el momento de la conexión. Este miembro se omite si szX25Address es una cadena vacía ("").

dwChannels

Reservado para uso futuro.

dwSubEntries

Valor que especifica el número de subintentos de varios vínculos asociados a esta entrada. Al llamar a RasSetEntryProperties, establezca este miembro en cero. Para agregar subentries a una entrada de libreta de teléfonos, use la función RasSetSubEntryProperties .

dwDialMode

Indica si RRAS debe marcar todas las subintentos de varios vínculos de esta entrada cuando la entrada está conectada por primera vez. Este miembro puede ser uno de los siguientes valores.

Valor	Significado
MPRDM_DialAll	Marque inicialmente todos los subbentries.
MPRDM_DialAsNeeded	Ajuste el número de subintentos según sea necesario el ancho de banda. RRAS usa los miembros dwDialExtraPercent, dwDialExtraSampleSeconds, dwDialHangUpExtraPercent y dwHangUpExtraSampleSeconds para determinar cuándo marcar o desconectar un subentry.

dwDialExtraPercent

Valor que especifica el porcentaje del ancho de banda total que está disponible en los subbentries conectados actualmente. RRAS marca un subentry adicional cuando el ancho de banda total que se usa supera el porcentaje dwDialExtraPercent del ancho de banda disponible durante al menos dwDialExtraSampleSeconds segundos.

Este miembro se omite a menos que el miembro dwDialMode especifique la marca MPRDM_DialAsNeeded .

dwDialExtraSampleSeconds

Valor que especifica el tiempo, en segundos, para el que el uso de ancho de banda actual debe superar el umbral especificado por dwDialExtraPercent antes de que RRAS marque un subentry adicional.

Este miembro se omite a menos que el miembro dwDialMode especifique la marca MPRDM_DialAsNeeded .

dwHangUpExtraPercent

Valor que especifica el porcentaje del ancho de banda total que está disponible en los subbentries conectados actualmente. RRAS finaliza (bloquea) una conexión de subentry existente cuando el ancho de banda total utilizado es inferior al porcentaje dwHangUpExtraPercent del ancho de banda disponible durante al menos dwHangUpExtraSampleSeconds segundos.

Este miembro se omite a menos que el miembro dwDialMode especifique la marca MPRDM_DialAsNeeded .

dwHangUpExtraSampleSeconds

Valor que especifica el tiempo, en segundos, para el que el uso de ancho de banda actual debe ser menor que el umbral especificado por dwHangUpExtraPercent antes de que RRAS finalice una conexión de subentry existente.

Este miembro se omite a menos que el miembro dwDialMode especifique la marca MPRDM_DialAsNeeded .

dwIdleDisconnectSeconds

Valor que especifica el tiempo, en segundos, después del cual se finaliza una conexión inactiva. A menos que se deshabilite el tiempo de espera de inactividad, se finaliza toda la conexión si la conexión está inactiva para el intervalo especificado. Este miembro puede especificar un valor de tiempo de espera o uno de los siguientes valores.

Valor	Significado
MPRIDS_Disabled	No hay tiempo de espera de inactividad para esta conexión.
MPRIDS_UseGlobalValue	Use el valor de preferencia de usuario como valor predeterminado.

dwType

Valor que especifica el tipo de entrada de la libreta telefónica. Este miembro puede ser uno de los siguientes tipos.

Tipo	Significado
MPRET_Phone	Línea telefónica, por ejemplo, módem, ISDN o X.25.
MPRET_Vpn	Red privada virtual.
MPRET_Direct	Conexión directa en serie o en paralelo.

dwEncryptionType

Valor que especifica el tipo de cifrado que se va a usar para el cifrado de punto a punto (MPPE) de Microsoft con la conexión. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
MPR_ET_None	No use el cifrado.
MPR_ET_Require	Uso de cifrado.
MPR_ET_RequireMax	Use el cifrado de máxima intensidad.
MPR_ET_Optional	Si es posible, use el cifrado.

El valor de dwEncryptionType no afecta a cómo se cifran las contraseñas. Si las contraseñas se cifran y cómo se cifran las contraseñas viene determinada por el protocolo de autenticación, por ejemplo, PAP, MS-CHAP o EAP.

dwCustomAuthKey

Valor que especifica la clave de autenticación que se va a proporcionar a un proveedor de Protocolo de autenticación extensible (EAP).

dwCustomAuthDataSize

Valor que especifica el tamaño de los datos a los que apunta el miembro lpbCustomAuthData .

lpbCustomAuthData

Puntero a los datos de autenticación que se van a usar con EAP.

guidId

Identificador único global (GUID) que representa esta entrada de la libreta de teléfonos. Este miembro es de solo lectura.

dwVpnStrategy

Estrategia de VPN que se va a usar al marcar una conexión VPN. Este miembro puede tener uno de los valores siguientes.

Valor	Significado
MPR_VS_Default	RRAS marca primero PPTP. Si se produce un error en PPTP, se intenta L2TP. El protocolo que se realiza correctamente se prueba primero en la marcación posterior de esta entrada.
MPR_VS_PptpOnly	RAS marca solo PPTP.
MPR_VS_PptpFirst	RAS siempre marca PPTP primero, L2TP segundo.
MPR_VS_L2tpOnly	RAS solo marca L2TP.
MPR_VS_L2tpFirst	RAS marca primero L2TP, PPTP segundo.

Comentarios

La estructura MPR_INTERFACE_2 tiene un número de miembros similares a los miembros de la estructura RASENTRY .

Los miembros siguientes de la estructura RASENTRY no tienen ningún homólogo en MPR_INTERFACE_2:

dwCountryID
dwCountryCode
szAreaCode
dwFramingProtocol

Windows de 64 bits: No admite el protocolo IPX.

Requisitos


Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	mprapi.h

Consulte también

MPR_INTERFACE_0

MPR_INTERFACE_1

MprAdminInterfaceGetInfo

MprAdminInterfaceSetInfo

Compartir a través de

estructura de MPR_INTERFACE_2 (mprapi.h)

Sintaxis

Members

Comentarios

Requisitos

Consulte también

Comentarios

Recursos adicionales