RAS Function Reference

sPBSet

RAS Function Reference

This function sets the phone book properties.

<DllImport("SapphireRAS.dll")> _
Public Function sPBSet(ByVal sEntryName As String, _
    ByVal sNumbers As String, ByVal sExtraInfo As String, ByVal sSettings As String, _
    ByVal lPBBefore As Integer, ByVal lPBAfter As Integer, _
    ByVal lPBManually As Integer, ByVal lPBWait As Integer, _
    ByVal lbUseCountryAndAreaCodes As Integer, ByVal lDialAsLocalCall As Integer, _
    ByVal lSpecificIpAddr As Integer, ByVal sIPAddress As String, _
    ByVal lSpecificNameServers As Integer, ByVal sIPAddresses As String, _
    ByVal lIpHeaderCompression As Integer, ByVal lSwCompression As Integer, _
    ByVal lSlip As Integer, ByVal lGPRS As Integer, ByVal lLicence As Integer) As Integer
End Function

Parameters

  sEntryName
    A string specifying the name of the phone book entry.
  sNumbers
    A string comprising of the country code, area code, local phone number, device name and device type separated by the tilder (~) character.
  sExtraInfo
    A string comprising of the flow control, credit card tone timeout, extra dialing command string and connection manager name (PPC2002 only) separated by the tilder (~) character.
  sSettings
    A string comprising of the dial-up timeout, baud rate, data bits, parity and stop bits separated by the tilder (~) character.
  lPBBefore
    An integer specifying the use terminal before connecting parameter. 1 = yes, 0 = no.
  lPBAfter
    An integer variable specifying the use terminal after connection parameter. 1 = yes, 0 = no.
  lPBManually
    An integer specifying the enter dialing commands manually parameter. 1 = yes, 0 = no.
  lPBWait
    An integer specifying the wait for dial tone before dialing. 1 = yes, 0 = no.
  lUseCountryAndAreaCodes
    An integer specifying the user country and area codes parameter. 1 = yes, 0 = no.
  lDialAsLocalCall
    An integer specifying the dial as local call parameter. 1 = yes, 0 = no.
  lSpecificIpAddr
    An integer specifying the use specific IP address parameter. 1 = yes, 0 = no.
  sIPAddress
    A string specifying the IP address to use with each element of the address separated by the tilder (~) character.
  lSpecificNameServers
    An integer specifying the use specific server address parameter. 1 = yes, 0 = no.
  sIPAddresses
    A string specifying the IP address of the DNS server, alternative DNS server, WINS server and alternative WINS server. Each element address and each element of each address is separated by the tilder (~) character.
  lIpHeaderCompression
    An integer specifying whether to use header compression. 1 = yes, 0 = no.
  lSwCompression
    An integer specifying whether to use software compression. 1 = yes, 0 = no.
  lSlip
    An integer specifying whether to use slip. 1 = yes, 0 = no.
  lGPRS
    An integer specifying whether the connection is a GPRS connection. 1 = yes, 0 = no.
  lLicence
    An integer specifying the licence number of the registered utility. If using in demo mode, enter 1234567890.

Return Values

  Returns a number indicating success or failure where 0 is successful. Use sRASErrMsg to get a string version of the error message.