blob: a8f8566fa25210e10c4d6d2cadd2d21dbffa2a15 [file] [log] [blame]
<html>
<head>
<title>enum RegError</title>
<style> h1 { font-size:20pt; margin-top:3pt; margin-bottom:7pt; }
h2 { font-family:"Arial"; font-size:16pt; margin-top:3pt; margin-bottom:5pt; }
h3 { font-size:13pt; margin-top:2pt; margin-bottom:3pt; }
h4 { font-size:10pt; font-weight:bold; margin-top:2pt; margin-bottom:1pt; }
dl { margin-top:1pt; margin-bottom:1pt; }
dl.member { margin-top:1pt; margin-bottom:1pt; background-color:#eeeeff; }
dt { font-size:10pt; font-weight:bold; margin-top:2pt; margin-bottom:1pt; }
dt.member { font-size:13pt; font-weight:bold; margin-top:2pt; margin-bottom:1pt; }
dt.simple { font-size:10pt; font-weight:normal; margin-top:2pt; margin-bottom:1pt; }
dd { font-size:10pt; margin-top:1pt; margin-bottom:1pt; }
dd.member { font-size:10pt; margin-top:1pt; margin-bottom:1pt; background-color:#ffffff; }
p { font-size:10pt; margin-top:3pt; margin-bottom:1pt; }
pre { font-family: Times, serif; font-size:10pt; margin-top:1pt; margin-bottom:1pt; }
tr { font-size:10pt; }
td { font-size:10pt; }
</style>
<meta HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8">
</head>
<body bgcolor="#ffffff">
<a name="_top_"> </a>
<table border="0" cellpadding="1" cellspacing="0">
<tr align="center" valign="top">
<td bgcolor="#eeeeff">&nbsp;<a href="../index.html" alt><font family="Arial" color="#000000" size="+1"><b>Overview</b></font></a>&nbsp;</td>
<td bgcolor="#eeeeff">&nbsp;<a href="index.html" alt><font family="Arial" color="#000000" size="+1"><b>Namespace</b></font></a>&nbsp;</td>
<td bgcolor="#eeeeff">&nbsp;<font family="Arial" color="#000000" size="+1">Class</font>&nbsp;</td>
<td bgcolor="#eeeeff">&nbsp;<a href="../index-files/index-1.html" alt><font family="Arial" color="#000000" size="+1"><b>Index</b></font></a>&nbsp;</td>
<td bgcolor="#eeeeff">&nbsp;<a href="../help.html" alt><font family="Arial" color="#000000" size="+1"><b>Help</b></font></a>&nbsp;</td>
</tr>
</table>
<table cellpadding="0" cellspacing="3">
<tr>
<td width="20%"><font size="-2">LIST OF:</font></td>
<td>
&nbsp;<a href="#envals"><font size="-2"><b>VALUES</b></font></a></td>
</tr>
</table>
<tr>
<p> </p>
</tr>
<hr>
<a href="../names/index.html" alt="Global Namespace in C++"><font size="+1"><b>::</b></font></a> <div align="center" style="background-color:#ccccff; line-height:26pt;"><h2>enum RegError</h2>
</div><hr>
<dl>
<dt>Summary</dt>
<dd>specifies the possible error codes which can occur using the registry API.</dd>
</dl>
<hr>
<a name="envals"> </a>
<table cellpadding="5" cellspacing="0" width="100%">
<tr bgcolor="#CCCCFF">
<td colspan="2"><h4>Values</h4>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_NO_ERROR"><b>REG_NO_ERROR</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>no error.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_INTERNAL_ERROR"><b>REG_INTERNAL_ERROR</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>internal registry error.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_REGISTRY_NOT_OPEN"><b>REG_REGISTRY_NOT_OPEN</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>registry is not open.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_REGISTRY_NOT_EXISTS"><b>REG_REGISTRY_NOT_EXISTS</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>registry does not exists.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_REGISTRY_READONLY"><b>REG_REGISTRY_READONLY</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>registry is open with readonly access rights.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_DESTROY_REGISTRY_FAILED"><b>REG_DESTROY_REGISTRY_FAILED</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>destroy a registry failed. There are may be any open keys.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_CANNOT_OPEN_FOR_READWRITE"><b>REG_CANNOT_OPEN_FOR_READWRITE</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>registry cannot be opened with readwrite access because the registry is already
open with readwrite access anywhere.
</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_INVALID_REGISTRY"><b>REG_INVALID_REGISTRY</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>registry is in an invalid state or the registry does not point to
a valid registry data file.
</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_KEY_NOT_OPEN"><b>REG_KEY_NOT_OPEN</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the key or key handle points to an invalid key or closed key.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_KEY_NOT_EXISTS"><b>REG_KEY_NOT_EXISTS</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the specified keyname points to a nonexisting key.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_CREATE_KEY_FAILED"><b>REG_CREATE_KEY_FAILED</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the key with the specified keyname cannot be created.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_DELETE_KEY_FAILED"><b>REG_DELETE_KEY_FAILED</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the specified key cannot be deleted. Maybe an open key handle exists to this key. </dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_INVALID_KEYNAME"><b>REG_INVALID_KEYNAME</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the keyname is invalid. This error will return if the keyname
is NULL but should not be NULL in the context of a called function.
</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_INVALID_KEY"><b>REG_INVALID_KEY</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the key is not in a valid state.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_VALUE_NOT_EXISTS"><b>REG_VALUE_NOT_EXISTS</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the key has no value</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_SET_VALUE_FAILED"><b>REG_SET_VALUE_FAILED</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>setting the specified value of a key failed.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_DELETE_VALUE_FAILED"><b>REG_DELETE_VALUE_FAILED</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>deleting of the key value failed.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_INVALID_VALUE"><b>REG_INVALID_VALUE</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the key has a invalid value or the value type is unknown.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_MERGE_ERROR"><b>REG_MERGE_ERROR</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>merging a key, the value and all subkeys failed.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_MERGE_CONFLICT"><b>REG_MERGE_CONFLICT</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>conflicts exists during the merge process of a key. This could happen if
the value of a key already exists and the merge process will replace it.
</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_DETECT_RECURSION"><b>REG_DETECT_RECURSION</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>a recursion was detected resolving different link targets. </dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_INVALID_LINK"><b>REG_INVALID_LINK</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the link is invalid and can not be resolved.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_INVALID_LINKNAME"><b>REG_INVALID_LINKNAME</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the specified linkname is not valid.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_INVALID_LINKTARGET"><b>REG_INVALID_LINKTARGET</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the linknane is not valid.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_LINKTARGET_NOT_EXIST"><b>REG_LINKTARGET_NOT_EXIST</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the link target points to a nonexisting key.</dd>
</dl>
</td>
</tr>
<tr bgcolor="white">
<td width="20%" valign="top"><a name="REG_BUFFERSIZE_TOSMALL"><b>REG_BUFFERSIZE_TOSMALL</b></a>
</td>
<td><dl>
<dt>Summary</dt>
<dd>the reserved buffer for the resolved keyname is to small. </dd>
</dl>
</td>
</tr>
</table>
<hr>
<a href="#_top_" class="objchapter">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright 2002 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303 USA.</p>
</body>