PPP_PROJECTION_INFO2 結構 (mprapi.h)

發行項
08/24/2023

包含點對點 (PPP) 交涉期間取得的資訊，適用于安全通訊端通道通訊協定 (SSTP) 、點對點通道通訊協定 (PPTP) ，以及第 2 層通道通訊協定 (L2TP) 。

語法

typedef struct _PPP_PROJECTION_INFO2 {
  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   dwEmbeddedEAPTypeId;
  DWORD   dwRemoteEapTypeId;
  DWORD   dwCcpError;
  DWORD   dwCompressionAlgorithm;
  DWORD   dwCcpOptions;
  DWORD   dwRemoteCompressionAlgorithm;
  DWORD   dwCcpRemoteOptions;
} PPP_PROJECTION_INFO2, *PPPP_PROJECTION_INFO2;

成員

dwIPv4NegotiationError

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

wszAddress[IPADDRESSLEN + 1]

Null 終止的 Unicode 字串，指定本機用戶端的 IPv4 位址。此字串的格式為「a.b.c.d」。 wszAddress成員只有在 dwIPv4NegotiationError 為 0 時才有效。

wszRemoteAddress[IPADDRESSLEN + 1]

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

dwIPv4Options

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

值	意義
PPP_IPCP_VJ	指出本機用戶端所傳送的 IP 資料包會使用 Van Parquetson 壓縮進行壓縮。

dwIPv4RemoteOptions

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

值	意義
PPP_IPCP_VJ	指出遠端伺服器所傳送的 IP 資料包 (，也就是本機電腦所接收的 IP 資料包，) 會使用 Van Compressson 壓縮進行壓縮。

IPv4SubInterfaceIndex

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

dwIPv6NegotiationError

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

bInterfaceIdentifier[8]

陣列，指定用戶端的 64 位 IPv6 介面識別碼。 128 位 IPv6 網際網路位址的最後 64 位會被視為介面識別碼，為上述 64 位提供強式唯一性層級。 bInterfaceIdentifier成員不得為 0，而且只有在dwIPv6NegotiationError成員為 0 時才有效。

bRemoteInterfaceIdentifier[8]

陣列，指定伺服器的 64 位 IPv6 介面識別碼。 128 位 IPv6 網際網路位址的最後 64 位會被視為介面識別碼，為上述 64 位提供強式唯一性層級。 bInterfaceIdentifier成員不得為 0，而且只有在dwIPv6NegotiationError成員為 0 時才有效。

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

未實作。必須是 0。

dwLcpRemoteTerminateReason

未實作。必須是 0。

dwLcpOptions

值，指定本機用戶端使用中 LCP 選項的相關資訊。此成員是下列旗標的組合。

值	意義
PPP_LCP_MULTILINK_FRAMING	連線使用多連結。
PPP_LCP_PFC	連線使用通訊協定欄位壓縮。
PPP_LCP_ACFC	連線使用位址和控制欄位壓縮。
PPP_LCP_SSHF	連線使用簡短序號標頭格式。
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	連線使用通訊協定欄位壓縮。
PPP_LCP_ACFC	連線使用位址和控制欄位壓縮。
PPP_LCP_SSHF	連線使用簡短序號標頭格式。
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時，這個成員的值才有效。

dwEmbeddedEAPTypeId

值，指定 EAP 驗證中使用的內部 EAP 方法型別識別碼。只有當 dwEapTypeId 成員設定為 IANA-EAP 中定義的 PEAP 時，這個成員的值才有效。

dwRemoteEapTypeId

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

dwCcpError

值，指定 PPP CCP 交涉的結果。值為 0 表示已順利交涉 CCP。非零值表示失敗，並表示控制通訊協定交涉期間發生的嚴重錯誤。

dwCompressionAlgorithm

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

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

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) 通訊協定。
RASCCPCA_STAC	STAC 選項 4。

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 2012 [僅限傳統型應用程式]
標頭	mprapi.h

共用方式為

PPP_PROJECTION_INFO2 結構 (mprapi.h)

語法

成員

需求

意見反應

其他資源