home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbsetlpwd.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.9 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                DBSETLPWD
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  DBSETLPWD
  6.  
  7.   FUNCTION:
  8.        Set the user SQL Server password in the LOGINREC structure.
  9.  
  10.   SYNTAX:
  11.        RETCODE DBSETLPWD(loginrec, password)
  12.  
  13.        LOGINREC  *loginrec;
  14.        char      *password;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   DBSETLPWD               Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This macro sets the user SQL Server password  in  the  LOGINREC
  28.          structure.  For it to have any effect, it must be called before
  29.          dbopen().
  30.  
  31.        o By default, the password field  of  the  LOGINREC  has  a  null
  32.          value.   Therefore, you do not need to call this routine if the
  33.          password is a null value.
  34.  
  35.        o DB-Library does not automatically blank  out  the  password  in
  36.          loginrec  after  a call to dbopen().  Therefore, if you want to
  37.          minimize the  risk  of  having  a  readable  password  in  your
  38.          DB-Library  program,  you should set password to something else
  39.          after you call dblogin().
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                DBSETLPWD
  47.   ______________________________________________________________________
  48.  
  49.   PARAMETERS:
  50.        loginrec -  A pointer to a  LOGINREC  structure,  which  will  be
  51.            passed  as  an argument to dbopen().  You can get one by cal-
  52.            ling dblogin().
  53.        password -   The  SQL Server  password  that  will  be  sent   to
  54.            SQL Server.   It  must be a null-terminated character string.
  55.            The maximum length of the string, not including the null ter-
  56.            minator, is 30 characters.
  57.  
  58.   RETURNS:
  59.        SUCCEED or FAIL.
  60.  
  61.   SEE ALSO:
  62.        dblogin, dbopen, DBSETLAPP, DBSETLHOST, DBSETLUSER
  63.  
  64.  
  65.  
  66.  
  67.