RAS Function Reference

sPBSet

RAS Function Reference

This function sets the phone book properties.

Declare Function sPBSet Lib "SapphireRAS.dll" (ByVal sEntryName As String, _
    ByVal sNumbers As String, ByVal sExtraInfo As String, ByVal sSettings As String, _
    ByVal lPBBefore As Long, ByVal lPBAfter As Long, _
    ByVal lPBManually As Long, ByVal lPBWait As Long, _
    ByVal lUseCountryAndAreaCodes As Long, ByVal lDialAsLocalCall As Long, _
    ByVal lSpecificIpAddr As Long, ByVal sIPAddress As String, _
    ByVal lSpecificNameServers As Long, ByVal sIPAddresses As String, _
    ByVal lIpHeaderCompression As Long, ByVal lSwCompression As Long, _
    ByVal lSlip As Long, ByVal lGPRS As Long, ByVal lLicence As Long) As Long

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 bar (|) character. If setting a GPRS connection, set the telephone number to ~GPRS!
  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 bar (|) character.
  lPBBefore
    A long specifying the use terminal before connecting parameter. 1 = yes, 0 = no.
  lPBAfter
    A long variable specifying the use terminal after connection parameter. 1 = yes, 0 = no.
  lPBManually
    A long specifying the enter dialing commands manually parameter. 1 = yes, 0 = no.
  lPBWait
    A long specifying the wait for dial tone before dialing. 1 = yes, 0 = no.
  lUseCountryAndAreaCodes
    A long specifying the user country and area codes parameter. 1 = yes, 0 = no.
  lDialAsLocalCall
    A long specifying the dial as local call parameter. 1 = yes, 0 = no.
  lSpecificIpAddr
    A long 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
    A long 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
    A long specifying whether to use header compression. 1 = yes, 0 = no.
  lSwCompression
    A long specifying whether to use software compression. 1 = yes, 0 = no.
  lSlip
    A long specifying whether to use slip. 1 = yes, 0 = no.
  lGPRS
    A long specifying whether the connection is a GPRS connection. 1 = yes, 0 = no.
  lLicence
    A long 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.