estructura MPR_INTERFACE_1 (mprapi.h)

Artículo
08/24/2023

La estructura MPR_INTERFACE_1 contiene información de configuración y estado para una interfaz de enrutador determinada.

Sintaxis

typedef struct _MPR_INTERFACE_1 {
  WCHAR                   wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1];
  HANDLE                  hInterface;
  BOOL                    fEnabled;
  ROUTER_INTERFACE_TYPE   dwIfType;
  ROUTER_CONNECTION_STATE dwConnectionState;
  DWORD                   fUnReachabilityReasons;
  DWORD                   dwLastError;
  LPWSTR                  lpwsDialoutHoursRestriction;
} MPR_INTERFACE_1, *PMPR_INTERFACE_1;

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

Especifica si la interfaz está habilitada. Este valor es TRUE si la interfaz está habilitada, FALSE si la interfaz está deshabilitada administrativamente.

dwIfType

Especifica el tipo de interfaz.

dwConnectionState

Especifica el estado actual de la interfaz, por ejemplo, conectado, desconectado o inaccesible. Para obtener una lista de los posibles estados, consulte ROUTER_CONNECTION_STATE.

fUnReachabilityReasons

Especifica un valor que representa un motivo por el que no se puede acceder a la interfaz. Consulte Motivos de inalcanzabilidad para obtener una lista de los valores posibles.

dwLastError

Especifica un valor distinto de cero si la interfaz no se puede conectar.

lpwsDialoutHoursRestriction

Puntero a una cadena Unicode que especifica las horas durante las que se restringe el acceso telefónico. El formato de esta cadena es:

&lt;day&gt;&lt;space&gt;&lt;time range&gt;&lt;space&gt;&lt;time range&gt; . . . &lt;NULL&gt;&lt;day&gt;. . . &lt;NULL&gt;&lt;NULL&gt;

Donde day es un número que corresponde a un día de la semana.

Número	Significado
0	Domingo
1	Lunes
2	Martes
3	Miércoles
4	Jueves
5	Viernes
6	Sábado

El intervalo de tiempo tiene el formato HH:MM-HH:MM, con notación de 24 horas.

El espacio> de cadena <de la sintaxis anterior denota un carácter de espacio. La cadena <NULL> denota un carácter NULO.

La cadena de restricción finaliza con dos caracteres NULOs consecutivos.

Ejemplo:

2 09:00-12:00 13:00-17:30&lt;NULL&gt;4 09:00-12:00 13:00-17:30&lt;NULL&gt;&lt;NULL&gt;

La cadena anterior restringe el acceso telefónico a martes y jueves de 9:00 a 12:00 p. m. y de 1:00 p. m. a 5:30 p. m.

Requisitos


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