Prepares a SQL statement for remote execution by SQLEXEC(В ).
SQLPREPARE(nStatementHandle, cSQLCommand, [cCursorName])
- Specifies the statement handle to the data source returned by SQLCONNECT(В ).
- Specifies the SQL statement passed to the data source. The SQL statement can contain a parameterized WHERE clause, which creates a parameterized view. All parameters in the WHERE clause must be defined before SQLPREPARE(В ) is issued. For example, if the parameters are variables, the variables must be created and initialized before SQLPREPARE(В ) is issued. For more information about parameterized views, see How to: Create Parameterized Views.
- Specifies the name of the Visual FoxPro cursor to which the result set is sent. If you don't include a cursor name, Visual FoxPro uses the default name SQLRESULT. For multiple result sets, new cursor names are derived by appending an incremented number to the name of the first cursor.
SQLPREPARE(В ) sends the SQL statement to the data source where it is compiled for faster execution. After the SQL statement is compiled, it can be executed with SQLEXEC(В ). If SQLEXEC(В ) is used to execute a SQL statement prepared with SQLPREPARE(В ), only the statement handle is required in SQLEXEC(В ).
gcAuthor = 'Smith' = SQLPREPARE(gnHandle, 'SELECT * FROM authors; WHERE au_lname = ?gcAuthor') = SQLEXEC(gnHandle) ... gcAuthor = 'Jones' = SQLEXEC(gnHandle)