<div class="content"><p> </p><p>The OpenCurrentConfig method is called by the client. In
response, the server attempts to open a handle to the <b>HKEY_CURRENT_CONFIG</b>
predefined key.</p><dl>
<dd>
<div><pre> error_status_t OpenCurrentConfig(
   [in, unique] PREGISTRY_SERVER_NAME ServerName,
   [in] REGSAM samDesired,
   [out] PRPC_HKEY phKey
 );
</pre></div>
</dd></dl><p><b>ServerName: </b>This SHOULD be sent as NULL and
MUST be ignored on receipt because the binding to the server is already
complete at this stage.</p><p><b>samDesired: </b>A bit field that describes the
wanted security access for the key. It MUST be constructed from one or more of
the values that are specified in section <span><a href="fefbc801-b141-4bb1-9dcb-bf366da3ae7e" data-linktype="relative-path">2.2.3</a></span>.</p><p><b>phKey: </b>A handle to the root key, <b>HKEY_CURRENT_CONFIG</b>,
as specified in section <span><a href="d93b4170-a865-47bc-a10b-13cb17fbc1b0" data-linktype="relative-path">3.1.1.7</a></span>.</p><p><b>Return Values: </b>The method returns 0
(ERROR_SUCCESS) to indicate success; otherwise, it returns a nonzero error
code, as specified in <span><a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a></span>
section <span><a href="../ms-erref/18d8fbe8-a967-4f1c-ae50-99ca8e491d2d" data-linktype="relative-path">2.2</a></span>.
The most common error codes are listed in the following table.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>0x00000005</p>
  <p>ERROR_ACCESS_DENIED</p>
  </td>
  <td>
  <p>Access is denied.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000013</p>
  <p>ERROR_WRITE_PROTECT</p>
  </td>
  <td>
  <p>A read or write operation was attempted to a volume
  after it was dismounted. The server can no longer service registry requests
  because server shutdown has been initiated.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p>Server Operations</p><p>If the registry server can no longer service registry
requests because server shutdown has been initiated, the server MUST return
ERROR_WRITE_PROTECT.</p><p>The server attempts to open the root key, <b>HKEY_CURRENT_CONFIG</b>,
and create a new valid context handle. The server MUST store the context handle
value in the handle table (HANDLETABLE) along with a mapping to the <b>HKEY_CURRENT_CONFIG</b>
key. The server MUST return the handle to that key in the <i>phKey</i>
parameter. The server MUST evaluate the security descriptor that is associated
with the key against the requested access that is expressed in the <i>samDesired</i>
parameter to determine whether the caller has the authority to open this key.</p><p>If the caller is permitted to open the key, the server MUST
return 0 to indicate success and place a valid context handle in the <i>phKey</i>
parameter. If the caller does not have access, the server MUST return
ERROR_ACCESS_DENIED (5).</p><p>The server validates the value of the <i>samDesired</i>
parameter set by the client. If the value of <i>samDesired</i> includes flags
set which are not listed in section 2.2.3, the server MUST return
ERROR_INVALID_PARAMETER.</p></div>