Difference between revisions of "SQLCONNECT()"

From Lianjapedia
Jump to: navigation, search
 
(7 intermediate revisions by one other user not shown)
Line 3: Line 3:
  
 
==Syntax==
 
==Syntax==
SQLCONNECT(<nStatementHandle>)
 
 
 
SQLCONNECT(<cDataSourceName> [, <cUserID> [, <cPassword>]])
 
SQLCONNECT(<cDataSourceName> [, <cUserID> [, <cPassword>]])
  
Line 13: Line 11:
 
The SQLCONNECT() function is used to connect to an ODBC data source and return a statement handle for use by other SQL functions.
 
The SQLCONNECT() function is used to connect to an ODBC data source and return a statement handle for use by other SQL functions.
  
 
+
{| class="wikitable" width="100%"
{| class="wikitable"
+
!width="30%"|Keywords||width="70%"|Description
!Keywords||Description
+
|-
+
|nStatementHandle||The workarea in which an ODBC data source is open and to which a new connection should be made.
+
|-
+
|}
+
 
+
Or
+
 
+
{| class="wikitable"
+
!Keywords||Description
+
 
|-
 
|-
 
|cDataSourceName||ODBC data source name
 
|cDataSourceName||ODBC data source name
Line 36: Line 24:
 
====Return values:====
 
====Return values:====
  
{| class="wikitable"
+
{| class="wikitable" width="100%"
!Return Value||Description
+
!width="30%"|Return Value||width="70%"|Description
 
|-
 
|-
|>0||Statement handle to connection
+
|>0||Statement handle to the connection
 
|-
 
|-
 
|&ndash;2||Connection creation error
 
|&ndash;2||Connection creation error
Line 47: Line 35:
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
nStatHand = SQLCONNECT("awhr", "testuser", "password", .T.)
+
nStatHand = sqlconnect("mylocal")
 +
// or
 +
nStatHand = sqlconnect("Driver={MySQL ODBC 5.1 Driver};Server=localhost;Database=mydb","myuser","mypass")
 
</code>
 
</code>
  
Line 53: Line 43:
 
[[Category:Functions]]
 
[[Category:Functions]]
 
[[Category:SQL]]
 
[[Category:SQL]]
[[Category:Remote Data Connectivity Functions]]
 
 
[[Category:ODBC Functions]]
 
[[Category:ODBC Functions]]
 
[[Category:SQL Functions]]
 
[[Category:SQL Functions]]

Latest revision as of 10:18, 31 January 2013

Purpose

Connect to an ODBC data source

Syntax

SQLCONNECT(<cDataSourceName> [, <cUserID> [, <cPassword>]])

See Also

SQLCANCEL(), SQLCOLUMNS(), SQLCOMMIT(), SQLDISCONNECT(), SQLEXEC(), SQLGETPROP(), SQLMORERESULTS(), SQLPREPARE(), SQLROLLBACK(), SQLSETPROP(), SQLSTRINGCONNECT(), SQLTABLES(), SQLTRANSACTION()

Description

The SQLCONNECT() function is used to connect to an ODBC data source and return a statement handle for use by other SQL functions.

Keywords Description
cDataSourceName ODBC data source name
cUserID Data source login user id
cPassword Data source login password

Return values:

Return Value Description
>0 Statement handle to the connection
–2 Connection creation error

Example

nStatHand = sqlconnect("mylocal")
// or
nStatHand = sqlconnect("Driver={MySQL ODBC 5.1 Driver};Server=localhost;Database=mydb","myuser","mypass")