com.sun.jna.platform.win32.WinRas Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jna-platform Show documentation
Show all versions of jna-platform Show documentation
Java Native Access Platform
/* Copyright (c) 2011 Timothy Wall, All Rights Reserved
*
* The contents of this file is dual-licensed under 2
* alternative Open Source/Free licenses: LGPL 2.1 or later and
* Apache License 2.0. (starting with JNA version 4.0.0).
*
* You can freely decide which license you want to apply to
* the project.
*
* You may obtain a copy of the LGPL License at:
*
* http://www.gnu.org/licenses/licenses.html
*
* A copy is also included in the downloadable source code package
* containing JNA, in file "LGPL2.1".
*
* You may obtain a copy of the Apache License at:
*
* http://www.apache.org/licenses/
*
* A copy is also included in the downloadable source code package
* containing JNA, in file "AL2.0".
*/
package com.sun.jna.platform.win32;
import com.sun.jna.Memory;
import com.sun.jna.Native;
import com.sun.jna.Pointer;
import com.sun.jna.Structure;
import com.sun.jna.Structure.FieldOrder;
import com.sun.jna.Union;
import com.sun.jna.platform.win32.BaseTSD.ULONG_PTR;
import com.sun.jna.platform.win32.Guid.GUID;
import com.sun.jna.platform.win32.WinDef.BOOL;
import com.sun.jna.platform.win32.WinDef.HWND;
import com.sun.jna.platform.win32.WinNT.HANDLE;
import com.sun.jna.platform.win32.WinNT.LUID;
import com.sun.jna.win32.StdCallLibrary.StdCallCallback;
/**
* Definitions for RASAPI32
*/
public interface WinRas {
public static final int ERROR_BUFFER_TOO_SMALL = 603;
public static final int ERROR_CANNOT_FIND_PHONEBOOK_ENTRY = 623;
public static final int MAX_PATH = 260;
public static final int UNLEN = 256;
public static final int PWLEN = 256;
public static final int DNLEN = 15;
public static final int RAS_MaxEntryName = 256;
public static final int RAS_MaxPhoneNumber = 128;
public static final int RAS_MaxCallbackNumber = 128;
public static final int RAS_MaxDeviceType = 16;
public static final int RAS_MaxDeviceName = 128;
public static final int RAS_MaxDnsSuffix = 256;
public static final int RAS_MaxAreaCode = 10;
public static final int RAS_MaxX25Address = 200;
public static final int RAS_MaxIpAddress = 15;
public static final int RAS_MaxFacilities = 200;
public static final int RAS_MaxUserData = 200;
public static final int RAS_MaxPadType = 32;
public static final int RASCS_Connected = 0x2000;
public static final int RASCS_Disconnected = 0x2001;
public static final int RASCM_UserName = 0x00000001;
public static final int RASCM_Password = 0x00000002;
public static final int RASCM_Domain = 0x00000004;
public static final int RASTUNNELENDPOINT_IPv4 = 1;
public static final int RASTUNNELENDPOINT_IPv6 = 2;
public static final String RASDT_Modem = "modem";
/**
* The RASEAPINFO structure contains user-specific Extensible Authentication Protocol (EAP) information.
* Use RASEAPINFO to pass this information to the RasDial function.
*/
@FieldOrder({"dwSizeofEapInfo", "pbEapInfo"})
public static class RASEAPINFO extends Structure {
public RASEAPINFO() {
super();
}
public RASEAPINFO(Pointer memory) {
super(memory);
read();
}
public RASEAPINFO(byte[] data) {
pbEapInfo = new Memory(data.length);
pbEapInfo.write(0, data, 0, data.length);
dwSizeofEapInfo = data.length;
allocateMemory();
}
public RASEAPINFO(String s) {
this(Native.toByteArray(s));
}
/**
* Specifies the size of the binary information pointed to by the
* pbEapInfo member.
*/
public int dwSizeofEapInfo;
/**
* Pointer to binary EAP information. RasDial uses this information for
* authentication.
*/
public Pointer pbEapInfo;
/**
* Get byte data.
*
* @return Byte data or null.
*/
public byte[] getData() {
return pbEapInfo == null ? null : pbEapInfo.getByteArray(0, dwSizeofEapInfo);
}
}
/**
* The RASDEVSPECIFICINFO structure is used to send a cookie for server
* validation and bypass point-to-point (PPP) authentication.
*/
@FieldOrder({"dwSize", "pbDevSpecificInfo"})
public static class RASDEVSPECIFICINFO extends Structure {
public RASDEVSPECIFICINFO() {
super();
}
public RASDEVSPECIFICINFO(Pointer memory) {
super(memory);
read();
}
public RASDEVSPECIFICINFO(byte[] data) {
pbDevSpecificInfo = new Memory(data.length);
pbDevSpecificInfo.write(0, data, 0, data.length);
dwSize = data.length;
allocateMemory();
}
public RASDEVSPECIFICINFO(String s) {
this(Native.toByteArray(s));
}
/**
* The size, in bytes, of the cookie in pbDevSpecificInfo.
*/
public int dwSize;
/**
* A pointer to a BLOB that contains the authentication cookie.
*/
public Pointer pbDevSpecificInfo;
/**
* Get byte data.
*
* @return Byte data or null.
*/
public byte[] getData() {
return pbDevSpecificInfo == null ? null : pbDevSpecificInfo.getByteArray(0, dwSize);
}
}
/**
* The RASDIALEXTENSIONS structure contains information about extended
* features of the RasDial function. Enable one or more of these extensions
* by passing a pointer to a RASDIALEXTENSIONS structure when you call
* RasDial. If you do not pass a pointer to a RASDIALEXTENSIONS structure to
* RasDial, RasDial uses the default settings that are noted in the
* following descriptions.
*/
@FieldOrder({"dwSize", "dwfOptions", "hwndParent", "reserved", "reserved1", "RasEapInfo", "fSkipPppAuth", "RasDevSpecificInfo"})
public static class RASDIALEXTENSIONS extends Structure {
public RASDIALEXTENSIONS() {
super();
dwSize = size();
}
public RASDIALEXTENSIONS(Pointer memory) {
super(memory);
read();
}
public static class ByReference extends RASDIALEXTENSIONS implements Structure.ByReference {
}
/**
* Specifies the size of this structure, in bytes. Set this member to
* sizeof(RASDIALEXTENSIONS). This indicates the version of the
* structure.
*/
public int dwSize;
/**
* A set of bit flags that specify RasDial extensions. The following bit
* flags are defined; set all undefined bits to zero.
*/
public int dwfOptions;
/**
* Handle to a parent window that a security DLL can use for dialog box
* creation and centering.
*/
public HWND hwndParent;
/**
* This member is reserved for future use. It must be set to zero.
*/
public ULONG_PTR reserved;
/**
* This member is reserved for future use. It must be set to zero.
*/
public ULONG_PTR reserved1;
/**
* A RASEAPINFO structure that contains user-specific Extensible
* Authentication Protocol (EAP) information.
*/
public RASEAPINFO RasEapInfo;
/**
* Windows 7 or later: If this member is TRUE, then Point to Point
* Protocol (PPP) authentication is skipped and the value in
* RasDevSpecificInfo will be passed to the server for validation.
* Otherwise, this member is FALSE and PPP authentication proceeds
* normally.
*/
public BOOL fSkipPppAuth;
/**
* Windows 7 or later: A RASDEVSPECIFICINFO structure that contains a
* cookie to be used for PPP authentication. This cookie is only valid
* if fSkipPppAuth is TRUE.
*/
public RASDEVSPECIFICINFO RasDevSpecificInfo;
}
/**
* The RASDIALPARAMS structure contains parameters that are used by RasDial
* to establish a remote access connection.
*/
@FieldOrder({"dwSize", "szEntryName", "szPhoneNumber", "szCallbackNumber", "szUserName", "szPassword", "szDomain"})
public static class RASDIALPARAMS extends Structure {
public RASDIALPARAMS() {
super();
dwSize = size();
}
public RASDIALPARAMS(Pointer memory) {
super(memory);
read();
}
public static class ByReference extends RASDIALPARAMS implements Structure.ByReference {
}
/**
* A value that specifies the size, in bytes, of the structure.
*/
public int dwSize;
/**
* A null-terminated string that contains the phone-book entry to use to
* establish the connection. An empty string ("") specifies a simple
* modem connection on the first available modem port, in which case a
* non-empty szPhoneNumber must be provided.
*/
public char[] szEntryName = new char[RAS_MaxEntryName + 1];
/**
* A null-terminated string that contains an overriding phone number. An
* empty string ("") indicates that the phone-book entry's phone number
* should be used. If szEntryName is "", szPhoneNumber cannot be "".
*/
public char[] szPhoneNumber = new char[RAS_MaxPhoneNumber + 1];
/**
* A null-terminated string that contains a callback phone number. An
* empty string ("") indicates that callback should not be used. This
* string is ignored unless the user has "Set By Caller" callback
* permission on the RAS server. An asterisk indicates that the number
* stored in the phone book should be used for callback.
*/
public char[] szCallbackNumber = new char[RAS_MaxCallbackNumber + 1];
/**
* A null-terminated string that contains the user's user name. This
* string is used to authenticate the user's access to the remote access
* server.
*/
public char[] szUserName = new char[UNLEN + 1];
/**
* A null-terminated string that contains the user's password. This
* string is used to authenticate the user's access to the remote access
* server.
*/
public char[] szPassword = new char[PWLEN + 1];
/**
* A null-terminated string that contains the domain on which
* authentication is to occur. An empty string ("") specifies the domain
* in which the remote access server is a member. An asterisk specifies
* the domain stored in the phone book for the entry.
*/
public char[] szDomain = new char[DNLEN + 1];
}
/**
* The RASCONN structure provides information about a remote access
* connection. The RasEnumConnections function returns an array of RASCONN
* structures.
*/
@FieldOrder({"dwSize", "hrasconn", "szEntryName", "szDeviceType", "szDeviceName", "szPhonebook", "dwSubEntry", "guidEntry", "dwFlags", "luid", "guidCorrelationId"})
public static class RASCONN extends Structure {
public RASCONN() {
super();
dwSize = size();
}
public RASCONN(Pointer memory) {
super(memory);
read();
}
public static class ByReference extends RASCONN implements Structure.ByReference {
}
/**
* Specifies the size, in bytes, of the RASCONN structure.
*/
public int dwSize;
/**
* A HRASCONN handle that defines the remote access connection. This
* handle is used in other remote access API calls.
*/
public HANDLE hrasconn;
/**
* A null-terminated string that specifies the phone-book entry used to
* establish the remote access connection. If the connection was
* established using an empty entry name, this string consists of a
* PERIOD followed by the connection phone number.
*/
public char[] szEntryName = new char[RAS_MaxEntryName + 1];
/**
* A null-terminated string that contains the device type through which
* the connection is made. See RASENTRY for a list of possible device
* types.
*/
public char[] szDeviceType = new char[RAS_MaxDeviceType + 1];
/**
* A null-terminated string that contains the device name through which
* the connection is made.
*/
public char[] szDeviceName = new char[RAS_MaxDeviceName + 1];
/**
* A null-terminated string that specifies the full path and file name
* of a phone-book (PBK) file.
*/
public char[] szPhonebook = new char[MAX_PATH];
/**
* For multilink connections, a value that specifies the subentry
* one-based index of a connected link.
*/
public int dwSubEntry;
/**
* A GUID (Globally Unique IDentifier) that represents the phone-book
* entry. The value of this member corresponds to that of the guidId
* member in the RASENTRY structure.
*/
public GUID guidEntry;
/**
* A value that specifies zero or more of the following flags.
*/
public int dwFlags;
/**
* A locally unique identifier (LUID) that specifies the logon session
* of the RAS connection.
*/
public LUID luid;
/**
* A GUID that specifies the RAS connection correlation ID. The
* correlation ID is logged with the RAS connection setup, disconnect
* and setup failure events and identifies the RAS connection event logs
* on the client and server.
*/
public GUID guidCorrelationId;
}
/**
* The RAS_STATS structure stores the statistics for a single-link RAS
* connection, or for one of the links in a multilink RAS connection.
*/
@FieldOrder({"dwSize", "dwBytesXmited", "dwBytesRcved", "dwFramesXmited", "dwFramesRcved", "dwCrcErr", "dwTimeoutErr", "dwAlignmentErr", "dwHardwareOverrunErr", "dwFramingErr", "dwBufferOverrunErr", "dwCompressionRatioIn", "dwCompressionRatioOut", "dwBps", "dwConnectDuration"})
public static class RAS_STATS extends Structure {
public RAS_STATS() {
super();
dwSize = size();
}
public RAS_STATS(Pointer memory) {
super(memory);
read();
}
/**
* Specifies the version of the structure. Set this member to
* sizeof(RAS_STATS) before using the structure in a function call.
*/
public int dwSize;
/**
* The number of bytes transmitted through this connection or link.
*/
public int dwBytesXmited;
/**
* The number of bytes received through this connection or link.
*/
public int dwBytesRcved;
/**
* The number frames transmitted through this connection or link.
*/
public int dwFramesXmited;
/**
* The number of frames received through this connection or link.
*/
public int dwFramesRcved;
/**
* The number of cyclic redundancy check (CRC) errors on this connection
* or link.
*/
public int dwCrcErr;
/**
* The number of timeout errors on this connection or link.
*/
public int dwTimeoutErr;
/**
* The number of alignment errors on this connection or link.
*/
public int dwAlignmentErr;
/**
* The number of hardware overrun errors on this connection or link.
*/
public int dwHardwareOverrunErr;
/**
* The number of framing errors on this connection or link.
*/
public int dwFramingErr;
/**
* The number of buffer overrun errors on this connection or link.
*/
public int dwBufferOverrunErr;
/**
* The compression ratio for the data being received on this connection
* or link.
*/
public int dwCompressionRatioIn;
/**
* The compression ratio for the data being transmitted on this
* connection or link.
*/
public int dwCompressionRatioOut;
/**
* The speed of the connection or link, in bits per second.
*/
public int dwBps;
/**
* The amount of time, in milliseconds, that the connection or link has
* been connected.
*/
public int dwConnectDuration;
}
/**
* This RASTUNNELENDPOINT structure is used to define the end-point of a
* virtual private network (VPN) tunnel.
*/
@FieldOrder({"addr"})
public static class RASIPV4ADDR extends Structure {
public RASIPV4ADDR() {
super();
}
public RASIPV4ADDR(Pointer memory) {
super(memory);
read();
}
/**
* A value that determines endpoint type
*/
public byte[] addr = new byte[8];
}
/**
* This RASTUNNELENDPOINT structure is used to define the end-point of a virtual private network (VPN) tunnel.
*/
@FieldOrder({"addr"})
public static class RASIPV6ADDR extends Structure {
public RASIPV6ADDR() {
super();
}
public RASIPV6ADDR(Pointer memory) {
super(memory);
read();
}
/**
* A value that determines endpoint type
*/
public byte[] addr = new byte[16];
}
/**
* The RASPPPIP structure contains the result of a PPP IP projection operation.
*/
@FieldOrder({"dwSize", "dwError", "szIpAddress", "szServerIpAddress", "dwOptions", "dwServerOptions"})
public static class RASPPPIP extends Structure {
public RASPPPIP() {
super();
dwSize = size();
}
public RASPPPIP(Pointer memory) {
super(memory);
read();
}
public static class ByReference extends RASPPPIP implements Structure.ByReference {
}
/**
* A value that specifies the size, in bytes, of the structure. This member must be set before it is used in a function call.
*/
public int dwSize;
/**
* A value that specifies the result of the PPP control protocol negotiation. A value of zero indicates success.
* A non-zero value indicates failure, and indicates the fatal error that occurred during the control protocol negotiation.
*/
public int dwError;
/**
* An array that contains a null-terminated string that is the client's IP address on the RAS connection.
* This address string has the form a.b.c.d.
*/
public char[] szIpAddress = new char[RAS_MaxIpAddress + 1];
/**
* An array that contains a null-terminated string that is the server's IP address on the RAS connection.
* This string is in a.b.c.d form.
* PPP does not require that servers provide this address, but servers will consistently return the address anyway.
* Other PPP vendors may not provide the address. If the address is not available, this member returns an empty string, "".
*/
public char[] szServerIpAddress = new char[RAS_MaxIpAddress + 1];
/**
* A value that specifies IPCP options for the local client.
*/
public int dwOptions;
/**
* A value that specifies IPCP options for the remote server.
*/
public int dwServerOptions;
}
/**
* This RASTUNNELENDPOINT structure is used to define the end-point of a virtual private network (VPN) tunnel.
*/
@FieldOrder({"dwType", "u"})
public static class RASTUNNELENDPOINT extends Structure {
public RASTUNNELENDPOINT() {
super();
}
public RASTUNNELENDPOINT(Pointer memory) {
super(memory);
read();
}
public static class UNION extends Union {
public static class ByReference extends UNION implements Structure.ByReference {
}
public RASIPV4ADDR ipv4;
public RASIPV6ADDR ipv6;
}
/**
* A value that determines endpoint type
*/
public int dwType;
/**
* The union structure
*/
public UNION u;
@Override
public void read() {
super.read();
switch (dwType) {
case RASTUNNELENDPOINT_IPv4:
u.setType(RASIPV4ADDR.class);
break;
case RASTUNNELENDPOINT_IPv6:
u.setType(RASIPV6ADDR.class);
break;
default:
u.setType(RASIPV4ADDR.class);
break;
}
u.read();
}
}
/**
* The RASCONNSTATUS structure describes the current status of a remote access connection. It is returned by the RasGetConnectStatus function.
*/
@FieldOrder({"dwSize", "rasconnstate", "dwError", "szDeviceType", "szDeviceName", "szPhoneNumber", "localEndPoint", "remoteEndPoint", "rasconnsubstate"})
public static class RASCONNSTATUS extends Structure {
public RASCONNSTATUS() {
super();
dwSize = size();
}
public RASCONNSTATUS(Pointer memory) {
super(memory);
read();
}
/**
* Specifies the structure size, in bytes.
*/
public int dwSize;
/**
* Specifies a RASCONNSTATE enumerator value that indicates the current state of the RasDial connection process;
* that is, the piece of the RasDial process that is currently executing.
*/
public int rasconnstate;
/**
* If nonzero, indicates the reason for failure. The value is one of the error values from the RasError.h
* header file or one of ERROR_NOT_ENOUGH_MEMORY or ERROR_INVALID_HANDLE.
*/
public int dwError;
/**
* A string that specifies the type of the current device, if available. For example, common device types supported by
* RAS are "modem", "pad", "switch", "ISDN", or "null". See RASENTRY for a complete list of possible device types.
*/
public char[] szDeviceType = new char[RAS_MaxDeviceType + 1];
/**
* A string that specifies the name of the current device, if available. This would be the name of the modem -
* for example, "Hayes SmartModem 2400"; the name of the PAD, for example "US Sprint"; or the name of a
* switch device, for example "Racal-Guardata".
*/
public char[] szDeviceName = new char[RAS_MaxDeviceName + 1];
/**
* A string that indicates the phone number dialed for this specific connection.
*/
public char[] szPhoneNumber = new char[RAS_MaxPhoneNumber + 1];
/**
* A RASTUNNELENDPOINT structure that contains the local client endpoint information of a virtual private network (VPN) endpoint.
*/
public RASTUNNELENDPOINT localEndPoint;
/**
* A RASTUNNELENDPOINT structure that contains the remote server endpoint information of a virtual private network (VPN) endpoint.
*/
public RASTUNNELENDPOINT remoteEndPoint;
/**
* A RASCONNSUBSTATE enumeration that specifies state information of an Internet Key Exchange version 2 (IKEv2) VPN tunnel.
*/
public int rasconnsubstate;
}
/**
* The RASCREDENTIALS structure is used with the RasGetCredentials and RasSetCredentials functions to specify the user credentials associated with a RAS phone-book entry.
*/
@FieldOrder({"dwSize", "dwMask", "szUserName", "szPassword", "szDomain"})
public static class RASCREDENTIALS extends Structure {
public RASCREDENTIALS() {
super();
dwSize = size();
}
public RASCREDENTIALS(Pointer memory) {
super(memory);
read();
}
public static class ByReference extends RASCREDENTIALS implements Structure.ByReference {
}
/**
* Specifies the size, in bytes, of the RASCREDENTIALS structure.
*/
public int dwSize;
/**
* Specifies a set of bit flags. These flags indicate the members of this structure that are valid. On input, set the flags to indicate the members of interest.
*/
public int dwMask;
/**
* Specifies a null-terminated string that contains a user name.
*/
public char[] szUserName = new char[UNLEN + 1];
/**
* Specifies a null-terminated string that contains a password.
*/
public char[] szPassword = new char[PWLEN + 1];
/**
* A null-terminated string that contains a domain name.
*/
public char[] szDomain = new char[DNLEN + 1];
}
/**
* The RASIPADDR structure contains an IP address of the form "a.b.c.d".
* The RASENTRY structure uses this structure to specify the IP addresses of various servers associated with an entry in a RAS phone book.
*/
@FieldOrder({"addr"})
public static class RASIPADDR extends Structure {
public RASIPADDR() {
super();
}
public RASIPADDR(Pointer memory) {
super(memory);
read();
}
public byte[] addr = new byte[4];
}
/**
* The RASENTRY structure describes a phone-book entry. The RasSetEntryProperties and RasGetEntryProperties
* functions use this structure to set and retrieve the properties of a phone-book entry.
*/
@FieldOrder({"dwSize", "dwfOptions", "dwCountryID", "dwCountryCode", "szAreaCode", "szLocalPhoneNumber", "dwAlternateOffset",
"ipaddr", "ipaddrDns", "ipaddrDnsAlt", "ipaddrWins", "ipaddrWinsAlt", "dwFrameSize", "dwfNetProtocols", "dwFramingProtocol",
"szScript", "szAutodialDll", "szAutodialFunc", "szDeviceType", "szDeviceName", "szX25PadType", "szX25Address", "szX25Facilities", "szX25UserData",
"dwChannels", "dwReserved1", "dwReserved2", "dwSubEntries", "dwDialMode", "dwDialExtraPercent", "dwDialExtraSampleSeconds", "dwHangUpExtraPercent",
"dwHangUpExtraSampleSeconds", "dwIdleDisconnectSeconds", "dwType", "dwEncryptionType", "dwCustomAuthKey", "guidId", "szCustomDialDll",
"dwVpnStrategy", "dwfOptions2", "dwfOptions3", "szDnsSuffix", "dwTcpWindowSize", "szPrerequisitePbk", "szPrerequisiteEntry", "dwRedialCount",
"dwRedialPause", "ipv6addrDns", "ipv6addrDnsAlt", "dwIPv4InterfaceMetric", "dwIPv6InterfaceMetric", "ipv6addr", "dwIPv6PrefixLength", "dwNetworkOutageTime"})
public static class RASENTRY extends Structure {
public RASENTRY() {
super();
dwSize = size();
}
public RASENTRY(Pointer memory) {
super(memory);
read();
}
public static class ByReference extends RASENTRY implements Structure.ByReference {
}
/**
* Specifies the size, in bytes, of the RASENTRY structure. Before calling RasSetEntryProperties or
* RasGetEntryProperties, set dwSize to sizeof(RASENTRY) to identify the version of the structure.
*/
public int dwSize;
/**
* A set of bit flags that specify connection options. Set one or more of the following flags.
*/
public int dwfOptions;
/**
* Specifies the TAPI country/region identifier. Use the RasGetCountryInfo function to enumerate
* country/region identifiers. This member is ignored unless the dwfOptions member specifies the RASEO_UseCountryAndAreaCodes flag.
*/
public int dwCountryID;
/**
* Specifies the country/region code portion of the phone number. The country/region code must
* correspond to the country/region identifier specified by dwCountryID. If dwCountryCode is zero, the
* country/region code is based on the country/region identifier specified by dwCountryID.
* This member is ignored unless dwfOptions specifies the RASEO_UseCountryAndAreaCodes flag.
*/
public int dwCountryCode;
/**
* Specifies the area code as a null-terminated string. If the dialing location does not have an area code,
* specify an empty string (""). Do not include parentheses or other delimiters in the area code string.
* For example, "206" is a valid area code; "(206)" is not. This member is ignored unless the dwfOptions member
* specifies the RASEO_UseCountryAndAreaCodes flag.
*/
public char[] szAreaCode = new char[RAS_MaxAreaCode + 1];
/**
* Specifies a null-terminated device-type specific destination string.
* The following table describes the contents of the szLocalPhoneNumber member for various device types.
*/
public char[] szLocalPhoneNumber = new char[RAS_MaxPhoneNumber + 1];
/**
* Specifies the offset, in bytes, from the beginning of the structure to a list of consecutive null-terminated strings.
* The last string is terminated by two consecutive null characters. The strings are alternate phone numbers that RAS
* dials in the order listed if the primary number (see szLocalPhoneNumber) fails to connect.
* The alternate phone number strings are ANSI or Unicode, depending on whether you use the ANSI or Unicode version of the structure.
*/
public int dwAlternateOffset;
/**
* Specifies the IP address to be used while this connection is active. This member is ignored unless dwfOptions specifies the RASEO_SpecificIpAddr flag.
*/
public RASIPADDR ipaddr;
/**
* Specifies the IP address of the DNS server to be used while this connection is active.
* This member is ignored unless dwfOptions specifies the RASEO_SpecificNameServers flag.
*/
public RASIPADDR ipaddrDns;
/**
* Specifies the IP address of a secondary or backup DNS server to be used while this connection is active.
* This member is ignored unless dwfOptions specifies the RASEO_SpecificNameServers flag.
*/
public RASIPADDR ipaddrDnsAlt;
/**
* Specifies the IP address of the WINS server to be used while this connection is active.
* This member is ignored unless dwfOptions specifies the RASEO_SpecificNameServers flag.
*/
public RASIPADDR ipaddrWins;
/**
* Specifies the IP address of a secondary WINS server to be used while this connection is active.
* This member is ignored unless dwfOptions specifies the RASEO_SpecificNameServers flag.
*/
public RASIPADDR ipaddrWinsAlt;
/**
* Specifies the IP address of a secondary WINS server to be used while this connection is active.
* This member is ignored unless dwfOptions specifies the RASEO_SpecificNameServers flag.
*/
public int dwFrameSize;
/**
* Specifies the network protocols to negotiate. This member can be a combination of the following flags.
*/
public int dwfNetProtocols;
/**
* Specifies the framing protocol used by the server. PPP is the emerging standard. SLIP is used mainly in UNIX environments.
* This member can be one of the following flags.
*/
public int dwFramingProtocol;
/**
* Specifies a null-terminated string that contains the name of the script file.
* The file name should be a full path. This field is only used for analog dial-up connections.
*/
public char[] szScript = new char[MAX_PATH];
/**
* Windows 2000 or later: This member is no longer supported. The szCustomDialDll member of the
* RASENTRY structure specifies the path to the custom-dial DLL. For more information on custom dialers, see RAS Custom Dialers.
*/
public char[] szAutodialDll = new char[MAX_PATH];
/**
* Windows 2000 or later: This member is no longer supported. See RAS Custom Dialers for more information on custom dialers.
*/
public char[] szAutodialFunc = new char[MAX_PATH];
/**
* Specifies a null-terminated string that indicates the RAS device type referenced by szDeviceName. This member can be one of the following string constants.
*/
public char[] szDeviceType = new char[RAS_MaxDeviceType + 1];
/**
* Contains a null-terminated string that contains the name of a TAPI device to use with this phone-book entry, for example,
* "XYZ Corp 28800 External". To enumerate all available RAS-capable devices, use the RasEnumDevices function.
*/
public char[] szDeviceName = new char[RAS_MaxDeviceName + 1];
/**
* Contains a null-terminated string that identifies the X.25 PAD type. Set this member to "" unless the entry
* should dial using an X.25 PAD. The szX25PadType string maps to a section name in PAD.INF.
*/
public char[] szX25PadType = new char[RAS_MaxPadType + 1];
/**
* Contains a null-terminated string that identifies the X.25 address to which to connect .
* Set this member to "" unless the entry should dial using an X.25 PAD or native X.25 device.
*/
public char[] szX25Address = new char[RAS_MaxX25Address + 1];
/**
* Contains a null-terminated string that specifies the facilities to request from the X.25 host at connection.
* This member is ignored if szX25Address is an empty string ("").
*/
public char[] szX25Facilities = new char[RAS_MaxFacilities + 1];
/**
* Contains a null-terminated string that specifies additional connection information supplied to the X.25
* host at connection. This member is ignored if szX25Address is an empty string ("").
*/
public char[] szX25UserData = new char[RAS_MaxUserData + 1];
/**
* Reserved for future use
*/
public int dwChannels;
/**
* Reserved. Must be zero.
*/
public int dwReserved1;
/**
* Reserved. Must be zero.
*/
public int dwReserved2;
/**
* Specifies the number of multilink subentries associated with this entry. When calling RasSetEntryProperties,
* set this member to zero. To add subentries to a phone-book entry, use the RasSetSubEntryProperties function.
*/
public int dwSubEntries;
/**
* Specifies whether RAS should dial all of this entry's multilink subentries when the entry is first connected.
* This member can be one of the following values.
*/
public int dwDialMode;
/**
* Specifies a percent of the total bandwidth available from the currently connected subentries.
* RAS dials an additional subentry when the total bandwidth used exceeds dwDialExtraPercent percent of the available
* bandwidth for at least dwDialExtraSampleSeconds seconds.
*/
public int dwDialExtraPercent;
/**
* Specifies the number of seconds that current bandwidth usage must exceed the threshold specified by dwDialExtraPercent
* before RAS dials an additional subentry.
*/
public int dwDialExtraSampleSeconds;
/**
* Specifies a percent of the total bandwidth available from the currently connected subentries.
* RAS terminates (hangs up) an existing subentry connection when total bandwidth used is less than dwHangUpExtraPercent
* percent of the available bandwidth for at least dwHangUpExtraSampleSeconds seconds.
*/
public int dwHangUpExtraPercent;
/**
* Specifies the number of seconds that current bandwidth usage must be less than the threshold specified by
* dwHangUpExtraPercent before RAS terminates an existing subentry connection.
*/
public int dwHangUpExtraSampleSeconds;
/**
* Specifies the number of seconds after which the connection is terminated due to inactivity.
* Note that unless the idle time out is disabled, the entire connection is terminated if the connection is
* idle for the specified interval. This member can specify a number of seconds, or one of the following values.
*/
public int dwIdleDisconnectSeconds;
/**
* The type of phone-book entry. This member can be one of the following types.
*/
public int dwType;
/**
* The type of encryption to use with the connection. The encryption is either provided by
* IPSec (for L2TP/IPSec connections) or by Microsoft Point-to-Point Encryption (MPPE). This member can be one of the following values.
*/
public int dwEncryptionType;
/**
* This member is used for Extensible Authentication Protocol (EAP). This member contains the authentication key provided to the EAP vendor.
*/
public int dwCustomAuthKey;
/**
* The GUID (Globally Unique Identifier) that represents this phone-book entry. This member is read-only.
*/
public GUID guidId;
/**
* A null-terminated string that contains the full path and file name for the dynamic link library (DLL) that implements the custom-dialing functions.
* This DLL should export Unicode versions of functions named RasCustomDial, RasCustomHangup, RasCustomEntryDlg, and
* RasCustomDialDlg. These functions should have prototypes RasCustomDialFn and RasCustomHangUpFn as defined in Ras.h,
* and RasCustomDialDlgFn and RasCustomEntryDlgFn as defined in Rasdlg.h.
*/
public char[] szCustomDialDll = new char[MAX_PATH];
/**
* The VPN strategy to use when dialing a VPN connection. This member can have one of the following values.
*/
public int dwVpnStrategy;
/**
* A set of bits that specify connection options. This member is a continuation of the bits specified
* in the dwfOptions member. Set one or more of the following bit flags.
*/
public int dwfOptions2;
/**
* This parameter is reserved for future use.
*/
public int dwfOptions3;
/**
* Pointer to a string that specifies the Domain Name Service (DNS) suffix for the connection.
* This string can be Unicode depending on the version of the structure you are using.
*/
public char[] szDnsSuffix = new char[RAS_MaxDnsSuffix];
/**
* Specifies the TCP window size for all TCP sessions that run over this connection.
* Setting this value can increase the throughput of high-latency devices such as cellular phones.
*/
public int dwTcpWindowSize;
/**
* Pointer to a null-terminated string that specifies the full path and file name of a phone-book (PBK) file.
* This phone-book file contains the entry specified by the szPrerequisiteEntry member. This member is used only for VPN connections.
*/
public char[] szPrerequisitePbk = new char[MAX_PATH];
/**
* Pointer to a null-terminated string that specifies a phone-book entry.
* This entry should exist in the phone-book file specified by the szPrerequisitePbk member.
* The szPrerequisteEntry member specifies an entry that RAS dials prior to establishing the connection
* specified by this RASENTRY structure. This member is used only for VPN connections.
*/
public char[] szPrerequisiteEntry = new char[RAS_MaxEntryName + 1];
/**
* Specifies the number of times RAS attempts to redial a connection.
*/
public int dwRedialCount;
/**
* Specifies the number of seconds to wait between redial attempts.
*/
public int dwRedialPause;
/**
* Contains the IPv6 address of the preferred DNS. A RASIPV6ADDR type is identical to a in6_addr structure.
*/
public RASIPV6ADDR ipv6addrDns;
/**
* Contains the IPv6 address of the alternate DNS. A RASIPV6ADDR type is identical to a in6_addr structure.
*/
public RASIPV6ADDR ipv6addrDnsAlt;
/**
* Sets the metric of the IPv4 stack for this interface.
*/
public int dwIPv4InterfaceMetric;
/**
* Sets the metric of the IPv6 stack for this interface.
*/
public int dwIPv6InterfaceMetric;
/**
* Specifies the client's IPv6 address negotiated by the server and the client.
*/
public RASIPV6ADDR ipv6addr;
/**
* The length of the IPv6 address prefix in ipv6addr.
*/
public int dwIPv6PrefixLength;
/**
* Specifies the amount of time, in minutes, that IKEv2 packets will be
* retransmitted without a response before the connection is considered lost.
* Increase this value to support connection persistence during network outages.
*/
public int dwNetworkOutageTime;
}
/**
* The asynchronous dial calback interface
*/
public interface RasDialFunc2 extends StdCallCallback {
public int dialNotification(int dwCallbackId, int dwSubEntry, HANDLE hrasconn, int unMsg, int rascs, int dwError, int dwExtendedError);
}
}