RAS API上的其他Function

來源:cww

取得目前連線資訊
    Function GetAllConnects(ConnEntry() as RASCONN) As Long
       傳回值:總共連線數
       使用方式 :
       Dim Conn() AS RASCONN
       Dim icnt as Long
       icnt = GetAllConnects(Conn())


取得所有撥號網路Entry的資訊(不管有沒有連線)
    Function GetRasNameEntries(Entry() As RASENTRYNAME, _
                               Optional PhonePath As String) As Long
 傳回值:總共Entry數
       使用方式 :
       Dim Conn() AS RASENTRYNAME
       Dim icnt as Long
       icnt = GetRasNameEntries(Conn())

呼叫修改某一個連線Entry 的Window
    Sub EditEntry(ByVal EntryName As String, _
                  Optional ByVal PhonePath As String)
於撥號網路中新增一個Entry
    Sub CreateEntry(Optional ByVal PhonePath As String)
自動撥接
    Function DialUp(ByVal EntryName As String, ByVal UserN As String, _
          ByVal Pwd As String, Optional ByVal PhonePath As String) As Long
取消撥接
     Function HangUp(ByVal hconn As Long) As Boolean
       hconn的值來自於
       1.DialUp()的傳回值
       2.GetAllConnects() RASCONN結構參數中的hRasConn值

取得連線狀態
     Function GetConnectStatus(ByVal hocnn As Long) As Long
       hconn的值來自於
       1.DialUp()的傳回值
       2.GetAllConnects() RASCONN結構參數中的hRasConn值


'Below is in rasapi.bas
Public Const RAS_MaxEntryName = 256
Public Const RAS_MaxDeviceName = 128
Public Const RAS_MaxDeviceType = 16
Public Const RAS_MaxPhoneNumber = 128
Public Const RAS_MaxCallbackNumber = 128
Public Const UNLEN = 256
Public Const PWLEN = 256
Public Const DNLEN = 15
Public Const ERROR_INVALID_HANDLE = 6

Type RASCONN
   dwSize As Long '412
   hRasConn As Long
   szEntryName(RAS_MaxEntryName) As Byte
   szDeviceType(RAS_MaxDeviceType) As Byte
   szDeviceName(RAS_MaxDeviceName) As Byte
End Type

Type RASENTRYNAME
  dwSize As Long '264
  szEntryName(RAS_MaxEntryName) As Byte
End Type

Type RASDIALPARAMS
  dwSize As Long '1052
  szEntryName(RAS_MaxEntryName) As Byte
  szPhoneNumber(RAS_MaxPhoneNumber) As Byte
  szCallbackNumber(RAS_MaxCallbackNumber) As Byte
  szUserName(UNLEN) As Byte
  szPassword(PWLEN) As Byte
  szDomain(DNLEN) As Byte
End Type

Type RASCONNSTATUS
    dwSize As Long  '144
    RasConnState As Long
    dwError As Long
    szDeviceType(RAS_MaxDeviceType) As Byte
    szDeviceName(RAS_MaxDeviceName) As Byte
End Type

Declare Function RasDial Lib "rasapi32" _
  Alias "RasDialA" (DialExt As Long, ByVal lpPhoneBook As String, _
  RasDialParam As RASDIALPARAMS, ByVal NotifyType As Long, _
  ByVal Notifter As Long, hRasConn As Long) As Long
Declare Function RasCreatePhonebookEntry Lib "rasapi32" _
  Alias "RasCreatePhonebookEntryA" (ByVal hWnd As Long, ByVal lpPhoneBook As String) As Long
Declare Function RasEditPhonebookEntry Lib "rasapi32" _
  Alias "RasEditPhonebookEntryA" (ByVal hWnd As Long, ByVal lpPhoneBook As String, _
  ByVal lpEntryName As String) As Long
Declare Function RasGetErrorString Lib "rasapi32" _
  Alias "RasGetErrorStringA" (ByVal ErrValue As Long, ByVal lpErrStr As String, _
  ByVal cSize As Long) As Long
Declare Function RasEnumEntries& Lib "rasapi32" _
  Alias "RasEnumEntriesA" (ByVal res As String, ByVal lpszPhonebook As String, _
  lpRasEntryBuffer As Any, lpcb As Long, lpcEntries As Long)
Declare Function RasEnumConnections Lib "rasapi32" Alias _
      "RasEnumConnectionsA" (lprasconn As Any, _
       lpcb As Long, lpConnect As Long) As Long
Declare Function RasHangUp Lib "rasapi32" Alias _
      "RasHangUpA" (ByVal hRasConn As Long) As Long
Declare Function RasGetConnectStatus Lib "rasapi32" Alias _
      "RasGetConnectStatusA" (ByVal hRasConn As Long, _
      lprasconnstatus As RASCONNSTATUS) As Long
Declare Function RasGetEntryDialParams Lib "rasapi32" _
   Alias "RasGetEntryDialParamsA" (ByVal lpszPhonebook As String, _
   lpRasDialParams As RASDIALPARAMS, _
   lpfPassword As Byte) As Long

Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
Enum RasConnState
    RASCS_OpenPort = 0
    RASCS_PortOpened             '1
    RASCS_ConnectDevice          '2
    RASCS_DeviceConnected        '3
    RASCS_AllDevicesConnected    '4
    RASCS_Authenticate           '5
    RASCS_AuthNotify             '6
    RASCS_AuthRetry
    RASCS_AuthCallback
    RASCS_AuthChangePassword
    RASCS_AuthProject
    RASCS_AuthLinkSpeed
    RASCS_AuthAck
    RASCS_ReAuthenticate
    RASCS_Authenticated
    RASCS_PrepareForCallback
    RASCS_WaitForModemReset
    RASCS_WaitForCallback
    RASCS_Projected
    RASCS_StartAuthentication  '19
    RASCS_CallbackComplete
    RASCS_LogonNetwork         '21
    RASCS_Interactive = &H1000
    RASCS_RetryAuthentication
    RASCS_CallbackSetByCaller
    RASCS_PasswordExpired
    RASCS_Connected = &H2000
    RASCS_Disconnected
End Enum

'取得目前連線資訊
Public Function GetAllConnections(Conn() As RASCONN) As Long
    Dim dl&, size&, validConnection&, counter%
    ReDim Conn(0)
    Conn(0).dwSize = 412
    size = 412
    dl& = RasEnumConnections(Conn(0), size, validConnection)
    If validConnection > 0 Then
       ReDim Conn(validConnection - 1)
       Conn(0).dwSize = 412
       size = validConnection * 412
       dl& = RasEnumConnections(Conn(0), size, validConnection)
    End If
    If dl = 0 Then
       GetAllConnections = validConnection
    Else
       GetAllConnections = -1
    End If
End Function

'取得所有撥號網路Entry的資訊(不管有沒有連線)
Public Function GetRasNameEntries(Entry() As RASENTRYNAME, Optional PhonePath As String) As Long
Dim di As Long, lpcb As Long, lpentries As Long
Dim addit As Long
Dim i As Long

di& = RasEnumEntries(vbNullString, PhonePath, 0, 0, lpentries)
If lpentries > 0 Then
   i = lpentries - 1
   ReDim Entry(i)
   len5 = LenB(Entry(0))
   addit = (4 - (len5 Mod 4)) Mod 4
   Entry(0).dwSize = len5 + addit
   lpcb = Entry(0).dwSize * (i + 1)
   di& = RasEnumEntries(vbNullString, PhonePath, Entry(0), lpcb, lpentries)
End If
If di = 0 Then
   GetRasNameEntries = lpentries
Else
   GetRasNameEntries = -1
End If
End Function
'呼叫修改某一個連線Entry 的Window
Public Sub EditEntry(ByVal EntryName As String, Optional ByVal PhonePath As String)
Dim di As Long
di = RasEditPhonebookEntry(0, PhonePath, EntryName)
End Sub
'於撥號網路中新增一個Entry
Public Sub CreateEntry(Optional ByVal PhonePath As String)
Call RasCreatePhonebookEntry(0, PhonePath)
End Sub

'自動撥接(Win95 4, 5 個參數不傳,或為vbNullString)
Public Function DialUp(ByVal EntryName As String, ByVal UserN As String, _
    ByVal Pwd As String, Optional ByVal PhoneBook As String, Optional sDomain As String) As Long
Dim RasDialPara As RASDIALPARAMS
Dim bya() As Byte, di As Long
Dim len5 As Long, i As Long
Dim hRasConn As Long

len5 = LenB(RasDialPara)
i = (4 - (len5 Mod 4)) Mod 4
RasDialPara.dwSize = len5 + i '1052
bya = StrConv(EntryName, vbFromUnicode) + ChrB(0)
Call CopyByte(RasDialPara.szEntryName, bya)

bya = StrConv(UserN, vbFromUnicode) + ChrB(0)
Call CopyByte(RasDialPara.szUserName, bya)

bya = StrConv(Pwd, vbFromUnicode) + ChrB(0)
Call CopyByte(RasDialPara.szPassword, bya)

bya = StrConv(sDomain, vbFromUnicode) + ChrB(0)
Call CopyByte(RasDialPara.szDomain, bya)
'若使用以下CallBack function的方式,則RasDial()不等連線成功或失敗便結束。
di = RasDial(0, PhoneBook, RasDialPara, 0, AddressOf RasDialFunc, hRasConn)

'若第二、三個參數都是0則,RasDial會等連線成功或失敗後才執行下一行指令
'di = RasDial(0, PhoneBook, RasDialPara, 0, 0, hRasConn)

If di = 0 Then
   DialUp = hRasConn
Else
   DialUp = 0
   Dim str5 As String
   str5 = String(255, Chr(0))
   Call RasGetErrorString(di, str5, 256)
   MsgBox Left(str5, InStr(1, str5, Chr(0)) - 1), vbCritical
   Call HangUp(hRasConn)
End If
End Function





Public Sub RasDialFunc(ByVal unMsg As Long, _
                       ByVal ConnState As Long, _
                       ByVal dwError As Long)
If ConnState = &H2000 Then
   ' Connect Complete
End If

Debug.Print unMsg, ConnState
End Sub
'取消撥接
Public Function HangUp(ByVal hconn As Long) As Boolean
Dim st As Long, len5 As Long
Dim i As Long, ConStatus  As RASCONNSTATUS
st = RasHangUp(hconn)
len5 = LenB(ConStatus)
i = (4 - (len5 Mod 4)) Mod 4
ConStatus.dwSize = len5 + i
Do While True
  Call Sleep(0)
  i = RasGetConnectStatus(hconn, ConStatus)
  If i = ERROR_INVALID_HANDLE Then
     Exit Do
  End If
Loop
If st = 0 Then
   HangUp = True
Else
   HangUp = False
End If
End Function
'取得連線狀態
Public Function GetConnectStatus(ByVal hocnn As Long) As Long
Dim i As Long, ConStatus  As RASCONNSTATUS
Dim len5 As Long
len5 = LenB(ConStatus)
i = (4 - (len5 Mod 4)) Mod 4
ConStatus.dwSize = len5 + i
i = RasGetConnectStatus(hconn, ConStatus)
If i = 0 Then
   GetConnectStatus = ConStatus.RasConnState
Else
   GetConnectStatus = -1
End If
End Function
Private Sub CopyByte(dest() As Byte, sour() As Byte)
Dim sourL As Long, sourU As Long
Dim destL As Long, destU As Long, i As Long, j As Long
sourL = LBound(sour)
sourU = UBound(sour)
destL = LBound(dest)
destU = UBound(dest)
j = 0
For i = sourL To sourU
    dest(destL + j) = sour(i)
    j = j + 1
    If j >= (destU - destL) + 1 Then
       Exit For
    End If
Next i
End Sub