A while ago, I wrote a class to dial Windows due to work needs. I sorted it out and encapsulated several Windows Ras APIs. I put it on and gave everyone my suggestions. Now it supports reading the Windows dial-up connection list, dialing, hanging up, creating/deleting connections, and can be used for 98/2000/XP. Windows me and NT have not been tested, so it should be OK. In the future, if you have time, write it as a component and add support for dialing events.
uses
ras, Classes, SysUtils, StrUtils, Windows, Forms;
type
ERasError = Exception;
type
TRASConnection = class
PRivate
FPlatForm: integer;
FConnected: Boolean;
FRasEntries: TStringList;
FRasConn: HRASCONN;
FParams: RasDialParams;
Ferrno: integer;
function GetPassWord: string;
procedure SetPassword(Password: string);
function GetPhoneNo: string;
procedure SetPhoneNo(Number: string);
function GetCallBack: string;
procedure SetCallBack(Number: string);
function GetDomain: string;
procedure SetDomain(Domain: string);
function GetUserName: string;
procedure SetUserName(UserName: string);
function GetEntryName: string;
procedure SetEntryName(Entry: string);
function GetConnected: Boolean;
procedure SetConnected(AValue: Boolean);
function GetRasEntries: TStringList;
public
property RasEntries: TStringList read GetRasEntries;
property PhoneNumber: string read GetPhoneNo write SetPhoneNo;
property CallBackNumber: string read GetCallBack write SetCallBack;
property Domain: string read GetDomain write SetDomain;
property EntryName: string read GetEntryName write SetEntryName;
property username: string read GetUsername write SetUsername;
property password: string read GetPassword write SetPassword;
property Active: Boolean read GetConnected write SetConnected;
procedure Connect;
procedure DisConnect;
function GetErrorCode: integer;
procedure FreeAndHangup;
constructor Create; reintroduce;
destructor Destroy; override;
procedure CreateRasEntry;
procedure DeleteRasEntry(AEntryName: string);
//function GetErrorReason: integer;
end;
Implementation
{ TRASConnection }
procedure TRASConnection.Connect;
var
i: integer;
s: string;
Begin
FParams.dwSize := sizeof(RasDialParams);
i := RasDial(nil, nil, @FParams, 0, nil, @FRasConn);
if i <> 0 then begin
Ferrno := i;
case i of
691: s := 'Identity verification failed!';
692: s := 'Port opening failed!';
676: s := 'The line is busy, please wait and dial again!';
677: s := 'Voice response error!';
678: s := 'No answer!';
679: s := 'No carrier signal!';
680: s := 'No dial tone!';
else
s := 'Unknown error!';
end;
RasHangUp(FRasConn);
raise ERasError.Create(s);
end
else FConnected := True;
end;
procedure TRASConnection.DisConnect;
Begin
RasHangup(FRasConn);
FRasConn := 0;
end;
function TRASConnection.GetCallBack: string;
Begin
Result := string(FParams.szCallbackNumber);
end;
function TRASConnection.GetConnected: Boolean;
var
i, len, num: integer;
x: array of RASCONN;
Begin
Result := False;
SetLength(x, 1);
x[0].dwSize := sizeof(RASCONN);
len := x[0].dwSize;
num := 0;
RasEnumConnections(@x[0], @len, @num);
if num > 0 then begin
SetLength(x, num);
x[0].dwSize := sizeof(RASCONN);
len := x[0].dwSize; num := 0;
RasEnumConnections(@x[0], @len, @num);
for i := 1 to num do
if StrComp(x[i - 1].szEntryName, PChar(EntryName)) = 0 then begin
FRasConn := x[i - 1].hrasconn;
Result := True;
Break;
end;
end;
SetLength(x, 0);
end;
function TRASConnection.GetDomain: string;
Begin
Result := string(FParams.szDomain);
end;
function TRASConnection.GetErrorCode: integer;
Begin
Result := FErrno;
end;
function TRASConnection.GetPassword: string;
Begin
Results := '*********';
end;
function TRASConnection.GetPhoneNo: string;
Begin
Result := string(FParams.szPhoneNumber);
end;
function TRASConnection.GetEntryName: string;
Begin
Result := string(FParams.szEntryName);
end;
function TRASConnection.GetUserName: string;
Begin
Result := string(FParams.szUserName);
end;
procedure TRASConnection.SetCallBack(Number: string);
Begin
StrLCopy(FParams.szCallbackNumber, PChar(Number), sizeof(FParams.szCallbackNumber) - 1);
end;
procedure TRASConnection.SetConnected(AValue: Boolean);
Begin
if AValue and not GetConnected then Connect
else if not AValue and GetConnected then DisConnect;
end;
procedure TRASConnection.SetDomain(Domain: string);
Begin
StrLCopy(FParams.szDomain, PChar(Domain), sizeof(FParams.szDomain) - 1);
end;
procedure TRASConnection.SetPassword(Password: string);
Begin
StrLCopy(FParams.szPassword, PChar(Password), sizeof(FParams.szPassword) - 1);
end;
procedure TRASConnection.SetPhoneNo(Number: string);
Begin
StrLCopy(FParams.szPhoneNumber, PChar(Number), sizeof(FParams.szPhoneNumber) - 1);
end;
procedure TRASConnection.SetEntryName(Entry: string);
var
i: integer;
Begin
for i := 0 to FRasEntries.Count - 1 do
if FRasEntries.Strings[i] = Entry then begin
StrCopy(FParams.szEntryName, PChar(Entry));
Exit;
end;
StrCopy(FParams.szEntryName, '');
end;
procedure TRASConnection.SetUserName(UserName: string);
Begin
StrLCopy(FParams.szUserName, PChar(UserName), sizeof(FPArams.szUserName) - 1);
end;
procedure TRASConnection.FreeAndHangup;
Begin
if Active then DisConnect;
Free;
end;
function TRASConnection.GetRasEntries: TStringList;
var
ren: array of RASEntryName;
ren98: array of RASEntryName98;
c, l: integer;
Begin
FRasEntries.Clear;
c := 0;
case FPlatForm of
VER_PLATFORM_WIN32_WINDOWS:
Begin
setlength(ren98, 1);
ren98[0].dwSize := sizeof(RASENTRYNAME98);
l := sizeof(RASENTRYNAME98);
if RasEnumEntries(nil, nil, @ren98[0], @l, @c) = ERROR_BUFFER_TOO_SMALL then begin
setlength(ren, c);
RasEnumEntries(nil, nil, @ren98[0], @l, @c);
end;
while c > 0 do begin
FRasEntries.Add(string(ren98[c - 1].szEntryName));
Dec(c);
end;
SetLength(ren98, 0);
end;
VER_PLATFORM_WIN32_NT:
Begin
setlength(ren, 1);
ren[0].dwSize := sizeof(RASENTRYNAME);
l := sizeof(RASENTRYNAME);
if RasEnumEntries(nil, nil, @ren[0], @l, @c) = ERROR_BUFFER_TOO_SMALL then begin
setlength(ren, c);
RasEnumEntries(nil, nil, @ren[0], @l, @c);
end;
while c > 0 do begin
FRasEntries.Add(string(ren[c - 1].szEntryName));
Dec(c);
end;
SetLength(ren, 0);
end;
end;
if FRasEntries.Count>0 then EntryName:=FRasEntries.Strings[0];
Results := FRasEntries;
end;
constructor TRASConnection.Create;
var
OS: OSVersionInfoA;
Begin
inherited;
OS.dwOSVersionInfoSize:=sizeof(OSVersionInfoA);
GetVersionEx(OS);
FPlatForm:=OS.dwPlatformId;
FRasEntries := TStringList.Create;
GetRasEntries;
end;
destructor TRASConnection.Destroy;
Begin
FRasEntries.Free;
inherited;
end;
procedure TRASConnection.CreateRasEntry;
Begin
RasCreatePhonebookEntry(application.Handle,nil);
end;
procedure TRASConnection.DeleteRasEntry(AEntryName: string);
var
i: integer;
Begin
i:=FRasEntries.IndexOf(AEntryName);
if i=-1 then Exit;
FRasEntries.Delete(i);
if AEntryName=EntryName then
if FRasEntries.Count>0 then EntryName:=FRasEntries.Strings[0]
else EntryName:='';
RasDeleteEntry(nil,PChar(AEntryName));
end;
Api Statement:
function RasDial(
lpRasDialExtensions: PRASDIALEXTENSIONS;
lpszPhonebook: LPCTSTR;
lpRasDialParams: LPRASDIALPARAMS;
dwNotifierType: DWORD;
lpvNotifier: Pointer;
lphRasConn: LPHRASCONN): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasDialA';
function RasHangUp(rasconn: HRASCONN): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasHangUpA';
function RasGetEntryDialParams(
lpszPhonebook: LPCTSTR;
lprasdialparams: LPRASDIALPARAMS;
lpfPassword: LPBOOL): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasGetEntryDialParamsA';
function RasEnumEntries(
reserved: LPCTSTR;
lpszPhonebook: LPCTSTR;
lprasentryname: LPRASENTRYNAME;
lpcb: LPDWORD;
lpcEntries: LPDWORD): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasEnumEntriesA';
function RasEditPhonebookEntry(
hwnd: HWND;
lpszPhonebook: LPCTSTR;
lpszEntryName: LPCTSTR): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasEditPhonebookEntryA';
function RasGetEntryProperties(
lpszPhonebook: LPCTSTR;
lpszEntry: LPCTSTR;
lpRasEntry: LPRASENTRY;
lpdwEntryInfoSize: LPDWORD;
lpbDeviceInfo: PBYTE;
lpdwDeviceInfoSize: LPDWORD): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasGetEntryPropertiesA';
function RasSetEntryProperties(
lpszPhonebook: LPCTSTR;
lpszEntry: LPCTSTR;
lpRasEntry: LPRASENTRY;
dwEntryInfoSize: DWORD;
lpbDeviceInfo: PByte;
dwDeviceInfoSize: DWORD): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasSetEntryPropertiesA';
function RasEnumConnections(
lprasconn: LPRASCONN;
lpcb: LPDWORD;
lpcConnections: LPDWORD): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasEnumConnectionsA';
function RasEnumDevices(
lpRasDevInfo: LpRasDevInfo;
lpcb: LPDWORD;
lpcdevices: LPDWORD): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasEnumDevicesA';
function RasCreatePhonebookEntry(
Handle: Hwnd; LpszPhoneBook: PChar): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasCreatePhonebookEntryA';
function RasDeleteEntry(
lpszPhonebook: PChar;
lpszEntry: PChar): DWORD;
stdcall; external 'RASAPI32.dll' name 'RasDeleteEntryA';