estrutura MPR_INTERFACE_1 (mprapi.h)

Artigo
08/24/2023

A estrutura MPR_INTERFACE_1 contém informações de configuração e status para uma interface de roteador específica.

Sintaxe

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;

Membros

wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]

Ponteiro para uma cadeia de caracteres Unicode que contém o nome da interface.

hInterface

Manipule para a interface.

fEnabled

Especifica se a interface está habilitada. Esse valor será TRUE se a interface estiver habilitada, FALSE se a interface estiver desabilitada administrativamente.

dwIfType

Especifica o tipo de interface.

dwConnectionState

Especifica o estado atual da interface, por exemplo, conectado, desconectado ou inacessível. Para obter uma lista de estados possíveis, consulte ROUTER_CONNECTION_STATE.

fUnReachabilityReasons

Especifica um valor que representa um motivo pelo qual a interface era inacessível. Confira Motivos de inacessibilidade para obter uma lista de valores possíveis.

dwLastError

Especifica um valor diferente de zero se a interface falhar ao se conectar.

lpwsDialoutHoursRestriction

Ponteiro para uma cadeia de caracteres Unicode que especifica os horários durante os quais a discagem é restrita. O formato dessa cadeia de caracteres é:

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

Em que dia é um numeral que corresponde a um dia da semana.

Numeral	Significado
0	Sunday
1	Monday
2	Terça-feira
3	Quarta-feira
4	Quinta-feira
5	Friday
6	Sábado

O intervalo de tempo é do formato HH:MM-HH:MM, usando notação de 24 horas.

O espaço> de cadeia <de caracteres na sintaxe anterior indica um caractere de espaço. A cadeia de caracteres <NULL> indica um caractere nulo.

A cadeia de caracteres de restrição é encerrada por dois caracteres nulos consecutivos.

Exemplo:

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;

A cadeia de caracteres anterior restringe a discagem para terças e quintas-feiras das 9h às 12h e das 13h às 17h30.

Requisitos


Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	mprapi.h