MPR_INTERFACE_2結構 (mprapi.h)

MPR_INTERFACE_2結構包含路由器需求撥號介面的資料。

語法

typedef struct _MPR_INTERFACE_2 {
  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;
} MPR_INTERFACE_2, *PMPR_INTERFACE_2;

成員

wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]

Unicode 字串的指標，其中包含介面的名稱。

hInterface

介面的控制碼。

fEnabled

值，指定介面是否已啟用。 如果介面已啟用，則此值為 TRUE ;如果介面已系統管理停用，則為 FALSE 。

dwIfType

識別 介面型別的 值。

dwConnectionState

值，描述介面的目前狀態，例如已連接、中斷連線或無法連線。 如需詳細資訊和可能狀態的清單，請參閱 ROUTER_CONNECTION_STATE。

fUnReachabilityReasons

值，描述介面無法連線的原因。 如需詳細資訊和可能值的清單，請參閱 無法連線的原因。

dwLastError

如果介面無法連線，則包含非零值的值。

dwfOptions

值，指定用來設定連接選項的位旗標。 您可以設定下表所列的其中一個旗標。

szLocalPhoneNumber[RAS_MaxPhoneNumber + 1]

值，指定包含電話號碼的 Null 終止字串。

szAlternates

連續 Null 終止 Unicode 字串清單的指標。 最後一個字串會以兩個連續的 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]

值，指定以 Null 結尾的字串，指出 szDeviceName所參考的 RRAS 裝置類型。 這個成員可以是下列其中一個字串常數。

szDeviceName[MPR_MaxDeviceName + 1]

包含 Null 終止的字串，其中包含要與此電話簿專案搭配使用的 TAPI 裝置名稱，例如「Fabrikam Inc 28800 External」。 若要列舉所有可用的 RAS 裝置，請使用 RasEnumDevices 函式 。

szX25PadType[MPR_MaxPadType + 1]

資料類型，包含識別 X.25 PAD 類型的 Null 終止字串。 除非專案應該使用 X.25 PAD 撥號，否則將此成員設定為空字串 (「」「) 。

Windows 2000 和 Windows NT：szX25PadType字串會對應至 PAD.INF 中的區段名稱。

szX25Address[MPR_MaxX25Address + 1]

包含以 Null 結尾的字串，可識別要連接的 X.25 位址。 除非專案應該使用 X.25 PAD 或原生 X.25 裝置來撥號，否則請將此成員設定為空字串 (「」「) 。

szX25Facilities[MPR_MaxFacilities + 1]

包含 Null 終止的字串，指定要在連線時間從 X.25 主機要求的功能。 如果 szX25Address 是空字串 (「」) ，則會忽略這個成員。

szX25UserData[MPR_MaxUserData + 1]

包含 Null 終止的字串，指定在連線時間提供給 X.25 主機的其他連線資料。 如果 szX25Address 是空字串 (「」) ，則會忽略這個成員。

dwChannels

保留供未來使用。

dwSubEntries

值，指定與此專案相關聯的多連結子專案數目。 呼叫 RasSetEntryProperties時，請將這個成員設定為零。 若要將子輸入新增至電話簿專案，請使用 RasSetSubEntryProperties 函式。

dwDialMode

指出第一次連接專案時，RRAS 是否應該撥入這個專案的所有多重連結子專案。 這個成員可以是下列其中一個值。

dwDialExtraPercent

值，指定目前已連線子專案可用的總頻寬百分比。 當使用的頻寬總計超過 dwDialExtraPercent 百分比的可用頻寬時，至少 dwDialExtraSampleSeconds 秒，RRAS 會撥入額外的子專案。

除非 dwDialMode 成員指定 MPRDM_DialAsNeeded 旗標，否則會忽略這個成員。

dwDialExtraSampleSeconds

值，指定目前頻寬使用量必須超過 dwDialExtraPercent 在 RRAS 撥號其他子輸入之前所指定的臨界值。

除非 dwDialMode 成員指定 MPRDM_DialAsNeeded 旗標，否則會忽略這個成員。

dwHangUpExtraPercent

值，指定目前已連線子專案可用的總頻寬百分比。 當使用的頻寬總計小於 dwHangUpExtraPercent 百分比時，RRA (S 會在至少 dwHangUpExtraSampleSeconds 秒的可用頻寬百分比下終止) 停止回應。

除非 dwDialMode 成員指定 MPRDM_DialAsNeeded 旗標，否則會忽略這個成員。

dwHangUpExtraSampleSeconds

值，指定目前頻寬使用量必須小於 dwHangUpExtraPercent 在 RRAS 終止現有子連線之前所指定的臨界值。

除非 dwDialMode 成員指定 MPRDM_DialAsNeeded 旗標，否則會忽略這個成員。

dwIdleDisconnectSeconds

值，指定非使用中連線終止的時間，以秒為單位。 除非停用閒置逾時，否則如果連線在指定的間隔閒置，則會終止整個連線。 這個成員可以指定逾時值或下列其中一個值。

dwType

值，指定電話簿專案的類型。 這個成員可以是下列其中一種類型。

dwEncryptionType

值，指定要用於與連線之 Microsoft 點對點加密 (MPPE) 的加密類型。 這個成員可以是下列其中一個值。

dwEncryptionType的值不會影響密碼的加密方式。 密碼是否已加密，以及密碼加密的方式取決於驗證通訊協定，例如 PAP、MS-CHAP 或 EAP。

dwCustomAuthKey

值，指定要提供給 EAP) 廠商的可延伸驗證通訊協定 (驗證金鑰。

dwCustomAuthDataSize

值，指定 lpbCustomAuthData 成員所指向的資料大小。

lpbCustomAuthData

要與 EAP 搭配使用的驗證資料的指標。

guidId

代表此電話簿專案的全域唯一識別碼 (GUID) 。 這個成員是唯讀的。

dwVpnStrategy

撥號 VPN 連線時要使用的 VPN 策略。 這個成員可以有下列其中一個值。

備註

MPR_INTERFACE_2結構有一些類似RASENTRY結構成員的成員。

RASENTRY結構的下列成員在MPR_INTERFACE_2中沒有對應專案：

• dwCountryID
• dwCountryCode
• szAreaCode
• dwFramingProtocol

需求

另請參閱

MPR_INTERFACE_0

MPR_INTERFACE_1

MprAdminInterfaceGetInfo

MprAdminInterfaceSetInfo