struttura MPR_INTERFACE_1 (mprapi.h)

Articolo
08/24/2023

La struttura MPR_INTERFACE_1 contiene informazioni di configurazione e stato per una particolare interfaccia router.

Sintassi

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]

Puntatore a una stringa Unicode contenente il nome dell'interfaccia.

hInterface

Handle per l'interfaccia.

fEnabled

Specifica se l'interfaccia è abilitata. Questo valore è TRUE se l'interfaccia è abilitata, FALSE se l'interfaccia è disabilitata in modo amministrativo.

dwIfType

Specifica il tipo di interfaccia.

dwConnectionState

Specifica lo stato corrente dell'interfaccia, ad esempio connesso, disconnesso o non raggiungibile. Per un elenco dei possibili stati, vedere ROUTER_CONNECTION_STATE.

fUnReachabilityReasons

Specifica un valore che rappresenta un motivo per cui l'interfaccia non è raggiungibile. Vedere Motivi di mancata accessibilità per un elenco dei valori possibili.

dwLastError

Specifica un valore diverso da zero se l'interfaccia non riesce a connettersi.

lpwsDialoutHoursRestriction

Puntatore a una stringa Unicode che specifica gli orari durante i quali la disconnessità è limitata. Il formato per questa stringa è:

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

Dove giorno è un numero che corrisponde a un giorno della settimana.

Numero	Significato
0	Sunday
1	Monday
2	Tuesday
3	Wednesday
4	Thursday
5	Friday
6	Sabato

L'intervallo di tempo è nel formato HH:MM-HH:MM, utilizzando la notazione di 24 ore.

Lo spazio> stringa <nella sintassi precedente indica un carattere di spazio. La stringa <NULL> indica un carattere Null.

La stringa di restrizione viene terminata da due caratteri Null consecutivi.

Esempio:

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 stringa precedente limita la disconnessa a martedì e giovedì dalle 9:00 alle 12:00 e dalle 13:00 alle 17:30.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	mprapi.h

Vedi anche

MprAdminInterfaceCreate

MprAdminInterfaceEnum

MprAdminInterfaceGetInfo

ROUTER_CONNECTION_STATE

ROUTER_INTERFACE_TYPE

Informazioni di riferimento sulla gestione dei router

Strutture di gestione router

Motivi di non raggiungibilità

Condividi tramite