MPR_INTERFACE_1-Struktur (mprapi.h)

Artikel
08/24/2023

Die MPR_INTERFACE_1-Struktur enthält Konfigurations- und status Informationen für eine bestimmte Routerschnittstelle.

Syntax

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]

Zeiger auf eine Unicode-Zeichenfolge, die den Namen der Schnittstelle enthält.

hInterface

Handle für die -Schnittstelle.

fEnabled

Gibt an, ob die Schnittstelle aktiviert ist. Dieser Wert ist TRUE , wenn die Schnittstelle aktiviert ist, FALSE , wenn die Schnittstelle administrativ deaktiviert ist.

dwIfType

Gibt den Typ der Schnittstelle an.

dwConnectionState

Gibt den aktuellen Status der Schnittstelle an, z. B. verbunden, getrennt oder nicht erreichbar. Eine Liste der möglichen Zustände finden Sie unter ROUTER_CONNECTION_STATE.

fUnReachabilityReasons

Gibt einen Wert an, der einen Grund darstellt, warum die Schnittstelle nicht erreichbar war. Eine Liste möglicher Werte finden Sie unter Gründe für die Nichterreichbarkeit .

dwLastError

Gibt einen Wert ungleich null an, wenn die Schnittstelle keine Verbindung herstellen kann.

lpwsDialoutHoursRestriction

Zeiger auf eine Unicode-Zeichenfolge, die die Zeiten angibt, zu denen die Wählverbindung eingeschränkt ist. Das Format für diese Zeichenfolge lautet:

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

Dabei ist day eine Zahl, die einem Wochentag entspricht.

Ziffer	Bedeutung
0	Sonntag
1	Montag
2	Tuesday
3	Wednesday
4	Thursday
5	Freitag
6	Samstag

Der Zeitbereich hat die Form HH:MM-HH:MM, wobei die 24-Stunden-Notation verwendet wird.

Der Zeichenfolgenraum <> in der vorherigen Syntax gibt ein Leerzeichen an. Die Zeichenfolge <NULL> gibt ein NULL-Zeichen an.

Die Einschränkungszeichenfolge wird durch zwei aufeinanderfolgende NULL-Zeichen beendet.

Beispiel:

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;

Die vorangehende Zeichenfolge beschränkt die Einwahl auf Dienstag und Donnerstag von 9:00 bis 12:00 Uhr und von 13:00 bis 17:30 Uhr.

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	mprapi.h