PPP_PROJECTION_INFO結構 (mprapi.h)

PPP_PROJECTION_INFO 結構包含點對點 (PPP) 交涉期間取得的資訊,適用於安全套接字通道通訊協定 (SSTP) 、點對點通道通訊協定 (PPTP) ,以及第 2 層通道通訊協定 (L2TP) 。

語法

typedef struct _PPP_PROJECTION_INFO {
  DWORD   dwIPv4NegotiationError;
  WCHAR   wszAddress[IPADDRESSLEN + 1];
  WCHAR   wszRemoteAddress[IPADDRESSLEN + 1];
  DWORD   dwIPv4Options;
  DWORD   dwIPv4RemoteOptions;
  ULONG64 IPv4SubInterfaceIndex;
  DWORD   dwIPv6NegotiationError;
  BYTE    bInterfaceIdentifier[8];
  BYTE    bRemoteInterfaceIdentifier[8];
  BYTE    bPrefix[8];
  DWORD   dwPrefixLength;
  ULONG64 IPv6SubInterfaceIndex;
  DWORD   dwLcpError;
  DWORD   dwAuthenticationProtocol;
  DWORD   dwAuthenticationData;
  DWORD   dwRemoteAuthenticationProtocol;
  DWORD   dwRemoteAuthenticationData;
  DWORD   dwLcpTerminateReason;
  DWORD   dwLcpRemoteTerminateReason;
  DWORD   dwLcpOptions;
  DWORD   dwLcpRemoteOptions;
  DWORD   dwEapTypeId;
  DWORD   dwRemoteEapTypeId;
  DWORD   dwCcpError;
  DWORD   dwCompressionAlgorithm;
  DWORD   dwCcpOptions;
  DWORD   dwRemoteCompressionAlgorithm;
  DWORD   dwCcpRemoteOptions;
} PPP_PROJECTION_INFO, *PPPP_PROJECTION_INFO;

成員

dwIPv4NegotiationError

值,指定 PPP IPv4 網路控制通訊協定交涉的結果。 值為零表示已成功交涉 Ipv4。 非零值表示失敗,而且是在控制通訊協定交涉期間發生的嚴重錯誤。

wszAddress[IPADDRESSLEN + 1]

包含 Unicode 字串的陣列,指定本機用戶端的 IPv4 位址。 此字串的格式為 「a.b.c.d」。。 wszAddress 只有在 dwIPv4NegotiationError 為零時才有效。

wszRemoteAddress[IPADDRESSLEN + 1]

數位,其中包含指定遠端伺服器的 IPv4 位址的 Unicode 字串。 此字串的格式為 「a.b.c.d」。。 wszRemoteAddress 只有在 dwIPv4NegotiationError 為零時才有效。 如果位址無法使用,這個成員是空字串。

dwIPv4Options

值,指定本機用戶端的 IPCP 選項。

意義
PPP_IPCP_VJ
表示本機用戶端所傳送的IP數據報會使用 Van 您的壓縮來壓縮。

dwIPv4RemoteOptions

值,指定遠端伺服器的 IPCP 選項。

意義
PPP_IPCP_VJ
表示遠端伺服器所傳送的IP數據報 (,也就是本機電腦收到的IP數據報,) 會使用 Van 一元壓縮進行壓縮。

IPv4SubInterfaceIndex

值,指定對應至伺服器上連線的 IPv4 子介面索引。

dwIPv6NegotiationError

值,指定 PPP IPv6 網路控制通訊協定交涉的結果。 值為零表示已成功交涉 Ipv6。 非零值表示失敗,而且是在控制通訊協定交涉期間發生的嚴重錯誤。

bInterfaceIdentifier[8]

陣列,指定用戶端的64位IPv6介面識別碼。 128 位 IPv6 因特網地址的最後 64 個位會被視為「介面標識碼」,以提供前 64 位的強式唯一性層級。 bInterfaceIdentifier 只有在 dwIPv6NegotiationError 為零且不得為零時才有效。

bRemoteInterfaceIdentifier[8]

陣列,指定伺服器的 64 位 IPv6 介面識別碼。 128 位 IPv6 因特網地址的最後 64 個位會被視為「介面標識碼」,以提供前 64 位的強式唯一性層級。 bInterfaceIdentifier 只有在 dwIPv6NegotiationError 為零且不得為零時才有效。

bPrefix[8]

值,指定用戶端介面 IPv6 位址前綴。

dwPrefixLength

值,指定 bPrefix 的長度,以位為單位。

IPv6SubInterfaceIndex

值,指定對應至伺服器上連線的 IPv6 子介面索引。

dwLcpError

值,指定 PPP LCP 交涉的結果。 值為零表示已成功交涉 LCP。 非零值表示失敗,而且是在控制通訊協定交涉期間發生的嚴重錯誤。

dwAuthenticationProtocol

值,指定用來驗證本機客戶端的驗證通訊協定。 這個成員可以是下列其中一個值。

意義
PPP_LCP_PAP
密碼驗證通訊協定。
PPP_LCP_CHAP
挑戰交握驗證通訊協定。
PPP_LCP_EAP
可延伸的驗證通訊協定。

dwAuthenticationData

值,指定 dwAuthenticationProtocol 所指定之驗證通訊協定的其他資訊。 此成員可以是下列其中一個值:

意義
PPP_LCP_CHAP_MD5
MD5 CHAP
PPP_LCP_CHAP_MS
Microsoft CHAP。
PPP_LCP_CHAP_MSV2
Microsoft CHAP 第 2 版。

dwRemoteAuthenticationProtocol

值,指定用來驗證遠端伺服器的驗證通訊協定。 當需求撥號在用戶端和伺服器上使用不同的驗證通訊協定時,dwAuthenticationProtocoldwRemoteAuthenticationProtocol 會有所不同。 此成員可以是下列其中一個值:

意義
PPP_LCP_PAP
密碼驗證通訊協定。
PPP_LCP_CHAP
挑戰交握驗證通訊協定。
PPP_LCP_EAP
可延伸的驗證通訊協定。

dwRemoteAuthenticationData

值,指定 dwRemoteAuthenticationProtocol 所指定之驗證通訊協定的其他資訊。 當需求撥號在用戶端和伺服器上使用不同的驗證通訊協定時,dwAuthenticationDatadwRemoteAuthenticationData 會有所不同。 此成員可以是下列其中一個值:

意義
PPP_LCP_CHAP_MD5
MD5 CHAP。
PPP_LCP_CHAP_MS
Microsoft CHAP。
PPP_LCP_CHAP_MSV2
Microsoft CHAP 第 2 版。

dwLcpTerminateReason

保留供未來使用。 必須為零。

dwLcpRemoteTerminateReason

保留供未來使用。 必須為零。

dwLcpOptions

值,指定本機用戶端使用中 LCP 選項的相關信息。 此成員是下列旗標的組合:

意義
PPP_LCP_MULTILINK_FRAMING
聯機使用多重連結。
PPP_LCP_PFC
聯機使用通訊協定字段壓縮 (RFC 1172) 。
PPP_LCP_ACFC
聯機使用位址和控制字段壓縮 (RFC 1172) 。
PPP_LCP_SSHF
聯機使用簡短序號標頭格式 (請參閱 RFC 1990) 。
PPP_LCP_DES_56
聯機使用 DES 56 位加密。
PPP_LCP_3_DES
線上使用三重 DES 加密。
PPP_LCP_AES_128
聯機使用 128 位 AES 加密。
PPP_LCP_AES_256
聯機使用 256 位 AES 加密。

dwLcpRemoteOptions

值,指定遠端伺服器使用中 LCP 選項的相關信息。 此成員是下列旗標的組合:

意義
PPP_LCP_MULTILINK_FRAMING
聯機使用多重連結。
PPP_LCP_PFC
聯機使用通訊協定字段壓縮 (RFC 1172) 。
PPP_LCP_ACFC
聯機使用位址和控制字段壓縮 (RFC 1172) 。
PPP_LCP_SSHF
聯機使用簡短序號標頭格式 (請參閱 RFC 1990) 。
PPP_LCP_DES_56
聯機使用 DES 56 位加密。
PPP_LCP_3_DES
線上使用三重 DES 加密。
PPP_LCP_AES_128
聯機使用 128 位 AES 加密
PPP_LCP_AES_256
聯機使用 256 位 AES 加密。

dwEapTypeId

值,指定用來驗證本機用戶端的可延伸驗證通訊協定 (EAP) 類型識別碼。 只有當 dwAuthenticationProtocol是PPP_LCP_EAP時,這個成員的值才有效。

dwRemoteEapTypeId

值,指定用來驗證遠端伺服器的可延伸驗證通訊協定 (EAP) 類型識別碼。 只有當 dwRemoteAuthenticationProtocol為PPP_LCP_EAP時,這個成員的值才有效。

dwCcpError

值,指定 PPP CCP 交涉的結果。 值為零表示 CCP 已成功交涉。 非零值表示失敗,而且是在控制通訊協定交涉期間發生的嚴重錯誤。

dwCompressionAlgorithm

值,指定本機用戶端所使用的壓縮演算法。 下表顯示這個成員的可能值。

意義
RASCCPCA_MPPC
MICROSOFT 點對點壓縮 (MPPC) 通訊協定 (RFC 2118) 。
RASCCPCA_STAC
STAC 選項 4 (RFC 1974) 。

dwCcpOptions

值,指定本機用戶端上可用的壓縮類型。 支援下列類型:

意義
PPP_CCP_COMPRESSION
沒有加密的壓縮。
PPP_CCP_HISTORYLESS
Microsoft 點對點加密 (MPPE) 處於無狀態模式。 會話金鑰會在每個封包之後變更。 此模式可改善高延遲網路的效能,或遇到大量封包遺失的網路。
PPP_CCP_ENCRYPTION40BITOLD
使用 40 位金鑰的 MPPE 壓縮。
PPP_CCP_ENCRYPTION40BIT
使用 40 位金鑰的 MPPE 壓縮。
PPP_CCP_ENCRYPTION56BIT
使用56位金鑰的MPPE壓縮。
PPP_CCP_ENCRYPTION128BIT
使用 128 位金鑰的 MPPE 壓縮。
 

當透過第 2 層通道通訊協定 (L2TP) 建立連線時,會使用最後三個選項,而聯機會使用 IPSec 加密。

dwRemoteCompressionAlgorithm

值,指定遠端伺服器所使用的壓縮演算法。 支援下列演算法:

意義
RASCCPCA_MPPC
Microsoft 點對點壓縮 (MPPC) 通訊協定 ( RFC 2118) 。
RASCCPCA_STAC
STAC 選項 4 ( RFC 1974) 。

dwCcpRemoteOptions

值,指定遠端伺服器上可用的壓縮類型。 支援下列類型:

意義
PPP_CCP_COMPRESSION
沒有加密的壓縮。
PPP_CCP_HISTORYLESS
Microsoft 點對點加密 (MPPE) 處於無狀態模式。 會話金鑰會在每個封包之後變更。 此模式可改善高延遲網路的效能,或遇到大量封包遺失的網路。
PPP_CCP_ENCRYPTION40BITOLD
使用 40 位金鑰的 MPPE 壓縮。
PPP_CCP_ENCRYPTION40BIT
使用 40 位金鑰的 MPPE 壓縮。
PPP_CCP_ENCRYPTION56BIT
使用56位金鑰的MPPE壓縮。
PPP_CCP_ENCRYPTION128BIT
使用 128 位金鑰的 MPPE 壓縮。
ERROR_PPP_NOT_CONVERGING
遠端電腦和 RRAS 無法交集在位址交涉上。
 

當透過第 2 層通道通訊協定 (L2TP) 建立連線時,會使用最後三個選項,而聯機會使用 IPSec 加密。

規格需求

需求
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
標頭 mprapi.h

另請參閱

路由器管理參考

路由器管理結構