Platform SDK: RAS/Routing and RAS

RASPPPLCP

The RASPPPLCP structure constains information that describes the results of a PPP Link Control Protocol (LCP)/multi-link negotiation.

typedef  struct  tagRASPPPLCP {
  DWORD dwSize;
  BOOL  fBundled;
#if (WINVER >= 0x500)
  DWORD  dwError;
  DWORD  dwAuthenticationProtocol;
  DWORD  dwAuthenticationData;
  DWORD  dwEapTypeId;
  DWORD  dwServerAuthenticationProtocol;
  DWORD  dwServerAuthenticationData;
  DWORD  dwServerEapTypeId;
  BOOL   fMultilink;
  DWORD  dwTerminateReason;
  DWORD  dwServerTerminateReason;
  TCHAR  szReplyMessage[RAS_MaxReplyMessage];
  DWORD  dwOptions;
  DWORD  dwServerOptions;
#endif
}  RASPPPLCP;

Members

dwSize

Size of the RASPPPLCP structure. Ensure that this member contains the size of the structure before using the structure in a function call.

fBundled

If this member is TRUE, the connection is composed of multiple links. Otherwise, this member is FALSE.

dwError

If the negotiation was unsuccessful, dwError contains the error that occurred.

dwAuthenticationProtocol

The authentication protocol used to authenticate the client. This member can be one of the following values.

Value	Meaning
RASLCPAP_PAP	Password Authentication Protocol
RASLCPAP_SPAP	Shiva Password Authentication Protocol
RASLCPAP_CHAP	Challenge Handshake Authentication Protocol
RASLCPAP_EAP	Extensible Authentication Protocol

dwAuthenticationData

Provides additional information about the authentication protocol specified by the dwAuthenticationProtocol member. This member can be one of the following values.

Value	Meaning
RASLCPAD_CHAP_MD5	MD5 CHAP
RASLCPAD_CHAP_MS	Microsoft CHAP
RASLCPAD_CHAP_MSV2	Microsoft CHAP version 2

dwEapTypeId

Provides the type ID of the extensible authentication protocol (EAP) used to authenticate the local computer. The value of this member is valid only if dwAuthenticationProtocol is RASLCPAPP_EAP.

dwServerAuthenticationProtocol

The authentication protocol used to authenticate the server. See the dwAuthenticationProtocol member for a list of possible values.

dwServerAuthenticationData

Provides additional information about the authentication protocol specified by dwServerAuthenticationProtocol. See the dwAuthenticationData member for a list of possible values.

dwServerEapTypeId

Provides the type ID of the extensible authentication protocol (EAP) used to authenticate the remote computer. The value of this member is valid only if dwServerAuthenticationProtocol is RASLCPAP_EAP.

fMultilink

If this member is TRUE, the connection supports multi-link. Otherwise, this member is FALSE.

dwTerminateReason

This member always has a value of zero.

dwServerTerminateReason

This member always has a value of zero.

szReplyMessage[RAS_MaxReplyMessage]

Pointer to a string that contains the message, if any, from the authentication protocol success/failure packet.

dwOptions

Provides additional LCP options for the local computer. This member is a combination of the following flags.

Flag	Meaning
RASLCPO_PFC	Protocol Field Compression (see RFC 1172)
RASLCPO_ACFC	Address and Control Field Compression (see RFC 1172)
RASLCPO_SSHF	Short Sequence Number Header Format (see RFC 1990)
RASLCPO_DES_56	DES 56-bit encryption
RASLCPO_3_DES	Triple DES Encryption

dwServerOptions

Provides addition LCP options for the remote computer. This member is a combination of the following flags.

Flag	Meaning
RASLCPO_PFC	Protocol Field Compression (see RFC 1172)
RASLCPO_ACFC	Address and Control Field Compression (see RFC 1172)
RASLCPO_SSHF	Short Sequence Number Header Format (see RFC 1990)
RASLCPO_DES_56	DES 56-bit encryption
RASLCPO_3_DES	Triple DES Encryption

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Ras.h.
  Unicode: Declared as Unicode and ANSI structures.

RASPPPLCP

Members

Requirements

See Also