Full text search
function	SQLBrowseConnect

Library: ODBC Include: omodbc.xin

Returns: Numeric An SQL return code. The following values may be returned: SQL_SUCCESS (all connection information has been specified and the application is now connected to the data source). SQL_SUCCESS_WITH_INFO (all connection information has been specified and the application is now connected to the data source, but a message was issued). SQL_ERROR (an error occurred). SQL_INVALID_HANDLE (the handle is invalid). SQL_NEED_DATA (data is required).

Declaration

  define external counter function SQLBrowseConnect
     (  read-only SQL_handle_type ConnectionHandle,
        value stream InConnectionString,
        value counter StringLength1,
        modifiable stream OutConnectionString,
        value counter BufferLength,
        modifiable counter StringLength2 )

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. When all levels have been enumerated, a connection to the data source is completed and a complete connection string is returned by SQLBrowseConnect.

Input arguments:

• ConnectionHandle.
• InConnectionString. The browse request connection string.
• StringLength1. The length of InConnectionString.
• BufferLength. The maximum length of OutConnectionString.

Output arguments:

• OutConnectionString. The returned browse result connection string.
• StringLength2. The returned length of OutConnectionString.