PPP_PROJECTION_INFO結構 (mprapi.h)

發行項
03/05/2024

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

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

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

dwRemoteAuthenticationData

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

值	意義
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

另請參閱

路由器管理參考

路由器管理結構

共用方式為

PPP_PROJECTION_INFO結構 (mprapi.h)

語法

成員

規格需求

另請參閱

意見反應

其他資源