RASPPP_PROJECTION_INFO 結構 (ras.h)

發行項
03/01/2024

RASPPP_PROJECTION_INFO 結構包含因特網通訊協定第 4 版 (IPv4) 和 IPv6 投影作業的點對點對點 (PPP) 交涉期間取得的資訊，以及 PPP 連結控制通訊協定 (LCP) /multilink，以及壓縮控制通訊協定 (CCP) 交涉。

語法

typedef struct _RASPPP_PROJECTION_INFO {
  DWORD       dwIPv4NegotiationError;
  RASIPV4ADDR ipv4Address;
  RASIPV4ADDR ipv4ServerAddress;
  DWORD       dwIPv4Options;
  DWORD       dwIPv4ServerOptions;
  DWORD       dwIPv6NegotiationError;
  BYTE        bInterfaceIdentifier[8];
  BYTE        bServerInterfaceIdentifier[8];
  BOOL        fBundled;
  BOOL        fMultilink;
  DWORD       dwAuthenticationProtocol;
  DWORD       dwAuthenticationData;
  DWORD       dwServerAuthenticationProtocol;
  DWORD       dwServerAuthenticationData;
  DWORD       dwEapTypeId;
  DWORD       dwServerEapTypeId;
  DWORD       dwLcpOptions;
  DWORD       dwLcpServerOptions;
  DWORD       dwCcpError;
  DWORD       dwCcpCompressionAlgorithm;
  DWORD       dwCcpServerCompressionAlgorithm;
  DWORD       dwCcpOptions;
  DWORD       dwCcpServerOptions;
} RASPPP_PROJECTION_INFO, *PRASPPP_PROJECTION_INFO;

成員

dwIPv4NegotiationError

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

ipv4Address

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

ipv4ServerAddress

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

dwIPv4Options

值，指定本機用戶端的因特網通訊協定控制通訊協定 (IPCP) 選項。

值	意義
RASIPO_VJ	指出本機用戶端所傳送的IP數據報會使用 Van Parquetson 壓縮進行壓縮。

dwIPv4ServerOptions

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

值	意義
RASIPO_VJ	指出遠端伺服器所傳送的IP數據報 (，也就是本機計算機所接收的IP數據報，) 會使用 Van Compressson 壓縮進行壓縮。

dwIPv6NegotiationError

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

bInterfaceIdentifier[8]

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

bServerInterfaceIdentifier[8]

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

fBundled

如果連接是由多個連結所組成，則為TRUE的BOOL，否則為 FALSE。

fMultilink

如果連線支援多個連結，則為TRUE的BOOL，否則為 FALSE。

dwAuthenticationProtocol

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

值	意義
RASLCPAP_PAP	密碼驗證通訊協定。
RASLCPAP_SPAP	Shiva 密碼驗證通訊協定。
RASLCPAP_CHAP	挑戰交握驗證通訊協定。
RASLCPAP_EAP	可延伸驗證通訊協定。

dwAuthenticationData

值，指定 dwAuthenticationProtocol 所指定之驗證通訊協定的其他資訊。當客戶端和伺服器上的不同驗證通訊協定時，dwAuthenticationData 和 dwServerAuthenticationData。這個成員可以是下列其中一個值：

值	意義
RASLCPAD_CHAP_MD5	MD5 CHAP。
RASLCPAD_CHAP_MS	Microsoft CHAP。
RASLCPAD_CHAP_MSV2	Microsoft CHAP 第 2 版。

dwServerAuthenticationProtocol

值，指定用來驗證遠端伺服器的驗證通訊協定。這個成員可以是下列其中一個值：

值	意義
RASLCPAP_PAP	密碼驗證通訊協定。
RASLCPAP_SPAP	Shiva 密碼驗證通訊協定。
RASLCPAP_CHAP	挑戰交握驗證通訊協定。
RASLCPAP_EAP	可延伸驗證通訊協定。

dwServerAuthenticationData

值，指定 dwServerAuthenticationProtocol 所指定之驗證通訊協定的其他資訊。當客戶端和伺服器上的不同驗證通訊協定時，dwAuthenticationData 和 dwServerAuthenticationData。這個成員可以是下列其中一個值：

值	意義
RASLCPAD_CHAP_MD5	MD5 CHAP。
RASLCPAD_CHAP_MS	Microsoft CHAP。
RASLCPAD_CHAP_MSV2	Microsoft CHAP 第 2 版。

dwEapTypeId

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

dwServerEapTypeId

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

dwLcpOptions

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

值	意義
RASLCPO_PFC	聯機使用通訊協定字段壓縮 (RFC 1172) 。
RASLCPO_ACFC	聯機使用位址和控制字段壓縮 (RFC 1172) 。
RASLCPO_SSHF	聯機使用簡短序號標頭格式 (請參閱 RFC 1990) 。
RASLCPO_DES_56	聯機使用 DES 56 位加密。
RASLCPO_3_DES	線上使用三重 DES 加密。

dwLcpServerOptions

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

值	意義
RASLCPO_PFC	聯機使用通訊協定字段壓縮 (RFC 1172) 。
RASLCPO_ACFC	聯機使用位址和控制字段壓縮 (RFC 1172) 。
RASLCPO_SSHF	聯機使用簡短序號標頭格式 (請參閱 RFC 1990) 。
RASLCPO_DES_56	聯機使用 DES 56 位加密。
RASLCPO_3_DES	線上使用三重 DES 加密。

dwCcpError

dwCcpCompressionAlgorithm

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

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

dwCcpServerCompressionAlgorithm

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

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

dwCcpOptions

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

值	意義
RASCCPO_COMPRESSION	壓縮而不加密。
RASCCPO_HISTORYLESS	Microsoft 點對點加密 (MPPE) 處於無狀態模式。會話金鑰會在每個封包之後變更。此模式可改善高延遲網路或遇到大量封包遺失的網路效能。
RASCCPO_ENCRYPTION40BITOLD	使用 40 位金鑰的 MPPE 壓縮。
RASCCPO_ENCRYPTION40BIT	使用 40 位金鑰的 MPPE 壓縮。
RASCCPO_ENCRYPTION56BIT	使用56位金鑰的MPPE壓縮。
RASCCPO_ENCRYPTION128BIT	使用 128 位金鑰的 MPPE 壓縮。

dwCcpServerOptions

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

值	意義
RASCCPO_COMPRESSION	壓縮而不加密。
RASCCPO_HISTORYLESS	Microsoft 點對點加密 (MPPE) 處於無狀態模式。會話金鑰會在每個封包之後變更。此模式可改善高延遲網路或遇到大量封包遺失的網路效能。
RASCCPO_ENCRYPTION40BITOLD	使用 40 位金鑰的 MPPE 壓縮。
RASCCPO_ENCRYPTION40BIT	使用 40 位金鑰的 MPPE 壓縮。
RASCCPO_ENCRYPTION56BIT	使用56位金鑰的MPPE壓縮。
RASCCPO_ENCRYPTION128BIT	使用 128 位金鑰的 MPPE 壓縮。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
標頭	ras.h

另請參閱

RasGetProjectionInfoEx

遠端訪問服務 (RAS) 概觀

遠端訪問服務結構

共用方式為

RASPPP_PROJECTION_INFO 結構 (ras.h)

語法

成員

規格需求

另請參閱

意見反應

其他資源