PQsetdbLogin

Function

PQsetdbLogin is used to establish a new connection with the database server.

Prototype

PGconn *PQsetdbLogin(const char *pghost,
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *dbName,
                     const char *login,
                     const char *pwd);

Parameter

Table 1 PQsetdbLogin parameters

Return Value

PGconn * points to the object pointer that contains a connection. The memory is applied for by the function internally.

Precautions

• This function is the predecessor of PQconnectdb with a fixed set of parameters. When an undefined parameter is called, its default value is used. Write NULL or an empty string for any one of the fixed parameters that is to be defaulted.
• If the dbName value contains an = sign or a valid prefix in the connection URL, it is taken as a conninfo string and passed to PQconnectdb, and the remaining parameters are consistent with PQconnectdbParams parameters.

Example

For details, see Example.