home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbsetlpwd.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.4 KB  |  59 lines
  1. .Na "DBSETLPWD" 
  2. .Aa
  3. .Fu
  4. Set the user \*S password in the LOGINREC structure.
  5. .Ih "LOGINREC, setting the password in"
  6. .Ih "password, setting"
  7. .Sy
  8. .Sf "RETCODE DBSETLPWD(loginrec, password)"
  9. .Sp "LOGINREC" "*loginrec"
  10. .Sp "char" "*password"
  11. .Co
  12. .Bl
  13. This macro sets the user \*S password in the 
  14. LOGINREC
  15. structure.  
  16. For it to have any effect, it must be called before
  17. .I "dbopen()."
  18. .Bl
  19. By default, the password field of the LOGINREC has a null value.
  20. Therefore, you do not need to call this routine if the password
  21. is a null value.
  22. .Bl
  23. \*L does not automatically blank out the password in 
  24. .I loginrec
  25. after a call to
  26. .I "dbopen()."
  27. Therefore, if you want to minimize the risk of having a readable password
  28. in your \*L program, you should set
  29. .I password
  30. to something else after you call
  31. .I "dblogin()."
  32. .Bl
  33. \f3Note for Macintosh programmers:\f1  The MPW library
  34. does not provide a routine for entering passwords.
  35. The programmer must therefore supply such a routine, if one is desired.
  36. .Bz
  37. .Pa
  38. .Pi loginrec
  39. A pointer to a LOGINREC structure, which will be passed as
  40. an argument to 
  41. .I "dbopen()."
  42. You can get one by calling
  43. .I "dblogin()."
  44. .Pi password
  45. The \*S password that will be sent to \*S.
  46. It must be a null-terminated character string.
  47. The maximum length of the string, not including the null terminator,
  48. is 30 characters.
  49. .in -.375i
  50. .Re
  51. .br
  52. SUCCEED or FAIL.
  53. .Sa
  54. dblogin,
  55. dbopen,
  56. DBSETLAPP,
  57. DBSETLHOST,
  58. DBSETLUSER
  59.