SQLRTPutConnectionInfo

InstallShield 2016 » InstallScript Language Reference

Project • This information applies to the following project types:

InstallScript
InstallScript MSI

The SQLRTPutConnectionInfo2 function supersedes the SQLRTPutConnectionInfo function.

The SQLRTPutConnectionInfo function sets the connection information (the default server, default user name, and default password). This is useful in situations when you need to recall what an end user previously entered, like use of the Back button.

Note • The SQLRTPutConnectionInfo function uses SQLRT.dll in InstallScript projects and ISSQLSRV.dll in InstallScript MSI projects; therefore, it can be called only after SQLRTInitialize2 has already been called. To learn more, see Using the SQL Run-Time Functions in InstallScript and InstallScript MSI Projects.

Syntax

SQLRTPutConnectionInfo( szConnection, szServer, szUser, szPassword );

Parameters

SQLRTPutConnectionInfo Parameters

Parameter

Description

szConnection

Specifies the SQL Server connection.

szServer

Specifies the SQL Server.

szUser

Specifies the SQL Server login information.

szPassword

Specifies the password associated with a user account.

Return Values

SQLRTPutConnectionInfo Return Values

Return Value

Description

>=ISERR_SUCCESS

This function was able to establish a connection.

<ISERR_SUCCESS

This function failed to establish a connection.

SQL_ERROR_NOT_INITIALIZED (-10)

SQLRT.dll is not loaded.

See Also