MPR_INTERFACE_3 構造体 (mprapi.h)

MPR_INTERFACE_3構造体には、ルーターのデマンド ダイヤル インターフェイスのデータが含まれています。

構文

typedef struct _MPR_INTERFACE_3 {
  WCHAR                   wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1];
  HANDLE                  hInterface;
  BOOL                    fEnabled;
  ROUTER_INTERFACE_TYPE   dwIfType;
  ROUTER_CONNECTION_STATE dwConnectionState;
  DWORD                   fUnReachabilityReasons;
  DWORD                   dwLastError;
  DWORD                   dwfOptions;
  WCHAR                   szLocalPhoneNumber[RAS_MaxPhoneNumber + 1];
  PWCHAR                  szAlternates;
  DWORD                   ipaddr;
  DWORD                   ipaddrDns;
  DWORD                   ipaddrDnsAlt;
  DWORD                   ipaddrWins;
  DWORD                   ipaddrWinsAlt;
  DWORD                   dwfNetProtocols;
  WCHAR                   szDeviceType[MPR_MaxDeviceType + 1];
  WCHAR                   szDeviceName[MPR_MaxDeviceName + 1];
  WCHAR                   szX25PadType[MPR_MaxPadType + 1];
  WCHAR                   szX25Address[MPR_MaxX25Address + 1];
  WCHAR                   szX25Facilities[MPR_MaxFacilities + 1];
  WCHAR                   szX25UserData[MPR_MaxUserData + 1];
  DWORD                   dwChannels;
  DWORD                   dwSubEntries;
  DWORD                   dwDialMode;
  DWORD                   dwDialExtraPercent;
  DWORD                   dwDialExtraSampleSeconds;
  DWORD                   dwHangUpExtraPercent;
  DWORD                   dwHangUpExtraSampleSeconds;
  DWORD                   dwIdleDisconnectSeconds;
  DWORD                   dwType;
  DWORD                   dwEncryptionType;
  DWORD                   dwCustomAuthKey;
  DWORD                   dwCustomAuthDataSize;
  LPBYTE                  lpbCustomAuthData;
  GUID                    guidId;
  DWORD                   dwVpnStrategy;
  ULONG                   AddressCount;
  IN6_ADDR                ipv6addrDns;
  IN6_ADDR                ipv6addrDnsAlt;
  IN6_ADDR                *ipv6addr;
} MPR_INTERFACE_3, *PMPR_INTERFACE_3;

メンバー

wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]

インターフェイスの名前を含む Unicode 文字列へのポインター。

hInterface

インターフェイスへのハンドル。

fEnabled

インターフェイスが有効かどうかを示す 値です。 インターフェイスが有効になっている場合、この値は TRUE 、インターフェイスが管理上無効になっている場合は FALSE です。

dwIfType

インターフェイスの種類を識別する 値。

dwConnectionState

接続済み、切断済み、到達不能など、インターフェイスの現在の状態を表す 値。 詳細と考えられる状態の一覧については、「 ROUTER_CONNECTION_STATE」を参照してください。

fUnReachabilityReasons

インターフェイスに到達できない理由を示す 値。 詳細と使用可能な値の一覧については、「 到達不能の理由」を参照してください。

dwLastError

インターフェイスの接続に失敗した場合に 0 以外の値を含む 値。

dwfOptions

接続オプションの設定に使用されるビット フラグを指定する 値。 次の表に示すフラグのいずれかを設定できます。

szLocalPhoneNumber[RAS_MaxPhoneNumber + 1]

電話番号または IPv6 アドレスを含む null で終わる文字列を指定する 値。

szAlternates

Null で終わる連続する Unicode 文字列のリストへのポインター。 最後の文字列は、2 つの連続する null 文字で終了します。 これらの文字列は、プライマリ番号の接続に失敗した場合に、ルーターがダイヤルする代替電話番号です。 詳細については、「 szLocalPhoneNumber」を参照してください。

ipaddr

この接続がアクティブな間に使用される IP アドレスを示す 値です。 このメンバーは、 dwfOptions が MPRIO_SpecificIpAddr フラグを指定しない限り無視されます。

ipaddrDns

この接続がアクティブな間に使用される DNS サーバーの IP アドレスを示す 値です。 このメンバーは、 dwfOptions が MPRIO_SpecificNameServers フラグを指定しない限り無視されます。

ipaddrDnsAlt

この接続がアクティブな間に使用されるセカンダリまたはバックアップの DNS サーバーの IP アドレスを指定する 値です。 このメンバーは、 dwfOptions が MPRIO_SpecificNameServers フラグを指定しない限り無視されます。

ipaddrWins

この接続がアクティブな間に使用する WINS サーバーの IP アドレスを示す 値です。 このメンバーは、 dwfOptions が MPRIO_SpecificNameServers フラグを指定しない限り無視されます。

ipaddrWinsAlt

この接続がアクティブな間に使用するセカンダリ WINS サーバーの IP アドレスを示す 値です。 このメンバーは、 dwfOptions が MPRIO_SpecificNameServers フラグを指定しない限り無視されます。

dwfNetProtocols

ネゴシエートするネットワーク プロトコルを指定する 値。 このメンバーには、次のフラグを組み合わせて使用できます。

64 ビット Windows: MPRNP_Ipx フラグはサポートされていません

szDeviceType[MPR_MaxDeviceType + 1]

szDeviceName によって参照される RRAS デバイスの種類を示す null で終わる文字列を指定する 値。 このメンバーには、次のいずれかの文字列定数を指定できます。

szDeviceName[MPR_MaxDeviceName + 1]

"Fabrikam Inc 28800 External" など、この電話帳エントリで使用する TAPI デバイスの名前を含む null で終わる文字列が含まれます。 使用可能なすべての RAS 対応デバイスを列挙するには、 RasEnumDevices 関数を 使用します。

szX25PadType[MPR_MaxPadType + 1]

X.25 PAD 型を識別する null で終わる文字列を含むデータ型。 エントリが X.25 PAD を使用してダイヤルする必要がある場合を除き、このメンバーを空の文字列 ("") に設定します。

Windows 2000 と Windows NT: szX25PadType 文字列は、PAD.INF のセクション名にマップされます。

szX25Address[MPR_MaxX25Address + 1]

接続する X.25 アドレスを識別する null で終わる文字列が含まれます。 エントリが X.25 PAD またはネイティブ X.25 デバイスを使用してダイヤルする必要がある場合を除き、このメンバーを空の文字列 ("") に設定します。

szX25Facilities[MPR_MaxFacilities + 1]

接続時に X.25 ホストから要求する機能を指定する null で終わる文字列が含まれます。 szX25Address が空の文字列 ("") の場合、このメンバーは無視されます。

szX25UserData[MPR_MaxUserData + 1]

接続時に X.25 ホストに提供される追加の接続データを指定する null で終わる文字列が含まれます。 szX25Address が空の文字列 ("") の場合、このメンバーは無視されます。

dwChannels

将来利用するために予約されています。

dwSubEntries

このエントリに関連付けられているマルチリンク サブエントリの数を示す 値です。 RasSetEntryProperties を呼び出すときは、このメンバーを 0 に設定します。 電話帳エントリにサブエントリを追加するには、 RasSetSubEntryProperties 関数を 使用します。

dwDialMode

エントリが最初に接続されたときに、RRAS がこのエントリのすべてのマルチリンク サブエントリをダイヤルする必要があるかどうかを示します。 このメンバーには、次のいずれかの値を指定できます。

dwDialExtraPercent

現在接続されているサブエントリから使用可能な合計帯域幅の割合を示す 値。 使用される帯域幅の合計が、少なくとも dwDialExtraSampleSeconds 秒の使用可能な帯域幅の dwDialExtraPercent% を超えると、RRAS は追加のサブエントリをダイヤルします。

dwDialMode メンバーがMPRDM_DialAsNeeded フラグを指定しない限り、このメンバーは無視されます。

dwDialExtraSampleSeconds

RRAS が追加のサブエントリをダイヤルする前に、現在の帯域幅使用量が dwDialExtraPercent で指定されたしきい値を超える必要がある時間を秒単位で指定する値。

dwDialMode メンバーがMPRDM_DialAsNeeded フラグを指定しない限り、このメンバーは無視されます。

dwHangUpExtraPercent

現在接続されているサブエントリから使用可能な合計帯域幅の割合を示す 値。 使用される帯域幅の合計が、少なくとも dwHangUpExtraSampleSeconds 秒の使用可能な帯域幅の dwHangUpExtraPercent% 未満の場合、RRAS は既存のサブエントリ接続を終了 (ハングアップ) します。

dwDialMode メンバーがMPRDM_DialAsNeeded フラグを指定しない限り、このメンバーは無視されます。

dwHangUpExtraSampleSeconds

RRAS が既存のサブエントリ接続を終了する前に dwHangUpExtraPercent で指定されたしきい値より小さい現在の帯域幅の使用量を秒単位で指定する値。

dwDialMode メンバーがMPRDM_DialAsNeeded フラグを指定しない限り、このメンバーは無視されます。

dwIdleDisconnectSeconds

非アクティブな接続が終了する時間を秒単位で指定する 値。 アイドル タイムアウトが無効になっていない限り、指定した間隔で接続がアイドル状態の場合、接続全体が終了します。 このメンバーは、タイムアウト値、または次のいずれかの値を指定できます。

dwType

電話帳エントリの種類を示す 値です。 このメンバーには、次のいずれかの型を指定できます。

dwEncryptionType

接続で Microsoft Point-to-Point Encryption (MPPE) に使用する暗号化の種類を指定する 値です。 このメンバーには、次のいずれかの値を指定できます。

dwEncryptionType の値は、パスワードの暗号化方法には影響しません。 パスワードが暗号化されているかどうかとパスワードの暗号化方法は、認証プロトコル (PAP、MS-CHAP、EAP など) によって決まります。

dwCustomAuthKey

拡張認証プロトコル (EAP) ベンダーに提供される認証キーを指定する 値。

dwCustomAuthDataSize

lpbCustomAuthData メンバーが指すデータのサイズを示す 値です。

lpbCustomAuthData

EAP で使用する認証データへのポインター。

guidId

この電話帳エントリを表すグローバル一意識別子 (GUID)。 このメンバーは読み取り専用です。

dwVpnStrategy

VPN 接続をダイヤルするときに使用する VPN 戦略。 このメンバーには、次のいずれかの値を指定できます。

AddressCount

使用されていません。

ipv6addrDns

この接続がアクティブな間に使用される DNS サーバーの IP アドレスを示す 値です。

ipv6addrDnsAlt

この接続がアクティブな間に使用されるセカンダリまたはバックアップの DNS サーバーの IP アドレスを指定する 値です。

ipv6addr

使用しません。

解説

MPR_INTERFACE_3構造体には、RASENTRY 構造体のメンバーに似た多数のメンバーがあります。

RASENTRY 構造体の次のメンバーは、MPR_INTERFACE_3に対応するものがありません。

• dwCountryID
• dwCountryCode
• szAreaCode
• dwFramingProtocol

要件

関連項目

MPR_INTERFACE_0

MPR_INTERFACE_1

MPR_INTERFACE_2

MprAdminInterfaceGetInfo

MprAdminInterfaceSetInfo