<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Change logged in user of the active connection</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.fbsql-blob-size.html">fbsql_blob_size</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.fbsql-clob-size.html">fbsql_clob_size</a></div>
<div class="up"><a href="ref.fbsql.html">FrontBase Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.fbsql-change-user" class="refentry">
<div class="refnamediv">
<h1 class="refname">fbsql_change_user</h1>
<p class="verinfo">(PHP 4 >= 4.0.6, PHP 5)</p><p class="refpurpose"><span class="refname">fbsql_change_user</span> — <span class="dc-title">Change logged in user of the active connection</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.fbsql-change-user-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">bool</span> <span class="methodname"><strong>fbsql_change_user</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$user</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$password</code></span>
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$database</code></span>
[, <span class="methodparam"><span class="type">resource</span> <code class="parameter">$link_identifier</code></span>
]] )</div>
<p class="para rdfs-comment">
<span class="function"><strong>fbsql_change_user()</strong></span> changes the logged in user of the
specified connection. If the new user and password authorization fails,
the current connected user stays active.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.fbsql-change-user-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">user</code></em></span>
<dd>
<p class="para">
The new user name.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">password</code></em></span>
<dd>
<p class="para">
The new user password.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">database</code></em></span>
<dd>
<p class="para">
If specified, this will be the default or current database after the
user has been changed.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">
link_identifier</code></em></span><dd>
<p class="para">A FrontBase link identifier
returned by <span class="function"><a href="function.fbsql-connect.html" class="function">fbsql_connect()</a></span> or
<span class="function"><a href="function.fbsql-pconnect.html" class="function">fbsql_pconnect()</a></span>.</p><p class="para">If optional and not specified,
the function will try to find an open link to the FrontBase server and if no
such link is found it will try to create one as if
<span class="function"><a href="function.fbsql-connect.html" class="function">fbsql_connect()</a></span> was called with no arguments.</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.fbsql-change-user-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns <strong><code>TRUE</code></strong> on success or <strong><code>FALSE</code></strong> on failure.
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.fbsql-blob-size.html">fbsql_blob_size</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.fbsql-clob-size.html">fbsql_clob_size</a></div>
<div class="up"><a href="ref.fbsql.html">FrontBase Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
