structure MPR_INTERFACE_1 (mprapi.h)

Article
08/24/2023

La structure MPR_INTERFACE_1 contient des informations de configuration et de status pour une interface de routeur particulière.

Syntaxe

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;

Membres

wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]

Pointeur vers une chaîne Unicode qui contient le nom de l’interface.

hInterface

Gérer l’interface.

fEnabled

Spécifie si l’interface est activée. Cette valeur est TRUE si l’interface est activée et FALSE si l’interface est désactivée administrativement.

dwIfType

Spécifie le type d’interface.

dwConnectionState

Spécifie l’état actuel de l’interface, par exemple connecté, déconnecté ou inaccessible. Pour obtenir la liste des états possibles, consultez ROUTER_CONNECTION_STATE.

fUnReachabilityReasons

Spécifie une valeur qui représente la raison pour laquelle l’interface était inaccessible. Pour obtenir la liste des valeurs possibles , consultez Motifs de non-accessibilité .

dwLastError

Spécifie une valeur différente de zéro si l’interface ne parvient pas à se connecter.

lpwsDialoutHoursRestriction

Pointeur vers une chaîne Unicode qui spécifie les heures pendant lesquelles la numérotation est restreinte. Le format de cette chaîne est le suivant :

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

Où day est un nombre qui correspond à un jour de la semaine.

Chiffre	Signification
0	Dimanche
1	Lundi
2	Mardi
3	Mercredi
4	Jeudi
5	Vendredi
6	Samedi

L’intervalle de temps est de la forme HH:MM-HH:MM, à l’aide d’une notation de 24 heures.

L’espace> de chaîne <dans la syntaxe précédente désigne un caractère d’espace. La chaîne <NULL> désigne un caractère null.

La chaîne de restriction est terminée par deux caractères null consécutifs.

Exemple :

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 chaîne précédente limite la numérotation aux mardis et jeudis de 9h00 à 12h00 et de 13h00 à 17h30.

Configuration requise


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	mprapi.h