структура MPR_INTERFACE_1 (mprapi.h)

Статья
08/24/2023

Структура MPR_INTERFACE_1 содержит сведения о конфигурации и состоянии для определенного интерфейса маршрутизатора.

Синтаксис

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;

Члены

wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]

Указатель на строку Юникода, содержащую имя интерфейса.

hInterface

Дескриптор интерфейса.

fEnabled

Указывает, включен ли интерфейс. Это значение равно TRUE , если интерфейс включен, false , если интерфейс отключен административно.

dwIfType

Указывает тип интерфейса.

dwConnectionState

Указывает текущее состояние интерфейса, например подключенного, отключенного или недоступного. Список возможных состояний см. в разделе ROUTER_CONNECTION_STATE.

fUnReachabilityReasons

Задает значение, представляющее причину недоступности интерфейса. Список возможных значений см. в статье Причины недоступности .

dwLastError

Указывает ненулевое значение, если интерфейсу не удается подключиться.

lpwsDialoutHoursRestriction

Указатель на строку Юникода, указывающую время, в течение которого ограничивается исходящий вызов. Формат этой строки:

&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;

Где день — это цифра, соответствующая дню недели.

Цифра	Значение
0	Воскресенье
1	Понедельник
2	Вторник
3	Среда
4	Четверг
5	Пятница
6	Суббота

Диапазон времени имеет вид ЧЧ:ММ-ЧЧ:ММ с использованием 24-часовой нотации.

Строковое <пространство> в предыдущем синтаксисе обозначает символ пробела. Строка <NULL> обозначает символ NULL.

Строка ограничения завершается двумя последовательными символами NULL.

Пример

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;

Предыдущая строка ограничивает исходящий вызов по вторникам и четвергам с 9:00 до 12:00 и с 13:00 до 17:30.

Требования


Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	mprapi.h