 |
SQLBrowseConnect
..msdn Add comment W32 Constants Translate this page |
|
|
|
SQLBrowseConnect supports an iterative method of discovering and enumerating the attributes and attribute values required to connect to a data source. Each call to SQLBrowseConnect returns successive levels of attributes and attribute values. |
|
|
| Code examples: |
|
|
|
|
|
| Declaration: |
|
|
SQLRETURN SQLBrowseConnect(
SQLHDBC ConnectionHandle,
SQLCHAR * InConnectionString,
SQLSMALLINT StringLength1,
SQLCHAR * OutConnectionString,
SQLSMALLINT BufferLength,
SQLSMALLINT * StringLength2Ptr);
|
|
|
|
| FoxPro declaration: |
|
|
DECLARE SHORT SQLBrowseConnect IN odbc32;
INTEGER ConnectionHandle,;
STRING InConnectionString,;
INTEGER StringLength1,;
STRING @ OutConnectionString,;
INTEGER BufferLength,;
INTEGER @ StringLength2Ptr
|
|
|
|
| Parameters: |
|
ConnectionHandle
[Input]
Connection handle.
InConnectionString
[Input]
Browse request connection string (see "InConnectionString Argument" in "Comments").
StringLength1
[Input]
Length of *InConnectionString.
OutConnectionString
[Output]
Pointer to a buffer in which to return the browse result connection string.
BufferLength
[Input]
Length of the *OutConnectionString buffer.
StringLength2Ptr
[Output]
The total number of bytes available to return in *OutConnectionString. |
|
|
| Return value: |
|
| SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_NEED_DATA, SQL_ERROR, or SQL_INVALID_HANDLE. |
|
|
| My comment: |
|
SQLBrowseConnect requires an allocated connection. The driver may establish a connection with the data source during the browsing process.
On each call to SQLBrowseConnect, the application specifies the connection attribute values in the browse request connection string. The driver returns successive levels of attributes and attribute values in the browse result connection string; it returns SQL_NEED_DATA (99) as long as there are connection attributes that have not yet been enumerated in the browse request connection string. |
|
|
| Word Index links for the SQLBrowseConnect : |
|
|
|
|
|
| Translate this page: |
|
|
|
|
| • |
|
| Created: | 2002-03-20 21:33:53 | | Modified: | 2002-03-20 21:39:32 |
Visited in last 7 days: 18 |
Using SQLBrowseConnect to connect to a data source through a number of iterative calls (SQL Server) 