Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > media > main-testing > by-pkgid > 2c50825dd66d0497b96a67f7fab2ee84 > files > 5400

openoffice.org64-devel-doc-2.4.1.10-1mdv2008.1.x86_64.rpm

<html>
<head>
<title>Interface XAccessController</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="../../../../idl.css">
</head>
<body>
<div id="adc-idlref">

<a name="_top_"> </a><table class="navimain" border="0" cellpadding="3">
<tr>
<td class="navimain"><a href="../module-ix.html" class="navimain">Overview</a></td>
<td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td>
<td class="navimain"><a href="XAccessController-xref.html" class="navimain">Use</a></td>
<td class="navimainnone">Devguide</td>
<td class="navimain"><a href="../../../../index-files/index-1.html" class="navimain">Index</a></td>
</tr>
</table>
<table class="navisub" border="0" cellpadding="0">
<tr>
<td class="navisub"><a href="#MethodsSummary" class="navisub">Methods' Summary</a></td>
<td class="navisub"><a href="#MethodsDetails" class="navisub">Methods' Details</a></td>
<td class="navisub">Attributes' Summary</td>
<td class="navisub">Attributes' Details</td>
</tr>
</table>
<hr>
<table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;">
<tr>
<td><p class="namechain"><a href="../../../../module-ix.html" class="namechain">::</a> <a href="../../../module-ix.html" class="namechain">com</a> :: <a href="../../module-ix.html" class="namechain">sun</a> :: <a href="../module-ix.html" class="namechain">star</a> :: <a href="module-ix.html" class="namechain">security</a> :: </p>
</td>
</tr>
<tr>
<td class="title">interface XAccessController</td>
</tr>
<tr>
<td/></tr>
<tr>
<td><dl>
<dt><b>Description</b></dt>
<dd>Interface for checking permissions and invoking privileged or restricted
 actions.

 </dd>
<dt><b>Since </b></dt>
<dd>OpenOffice 1.1.2</dd>
</dl>
</td>
</tr>
</table>
<hr>
<a name="MethodsSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
<tr>
<td class="subtitle" colspan="2">Methods' Summary</td>
</tr>
<tr>
<td class="imsum_left"><a href="#checkPermission">checkPermission</a></td>
<td class="imsum_right">Determines whether the access request indicated by the specified
 permission should be allowed or denied, based on the security policy
 currently in effect.
 The semantics are equivalent to the security permission classes of
 the Java platform.
 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left"><a href="#doRestricted">doRestricted</a></td>
<td class="imsum_right">Perform the specified action restricting permissions to the given
 XAccessControlContext.
 The action is performed with the intersection of the permissions of the currently installed
 XAccessControlContext, the given XAccessControlContext and the security policy currently
 in effect. The latter includes static security, e.g. based on user credentials.
 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left"><a href="#doPrivileged">doPrivileged</a></td>
<td class="imsum_right">Perform the specified action adding a set of permissions defined by the given
 XAccessControlContext.
 The action is performed with the union of the permissions of the currently installed
 XAccessControlContext, the given XAccessControlContext and the security policy currently
 in effect. The latter includes static security, e.g. based on user credentials.
 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left"><a href="#getContext">getContext</a></td>
<td class="imsum_right">This method takes a "snapshot" of the current calling context
 and returns it.
 &nbsp;</td>
</tr>
</table>
<a name="MethodsDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
<tr>
<td class="subtitle">Methods' Details</td>
</tr>
<tr>
<td class="imdetail"><a name="checkPermission" class="membertitle">checkPermission</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center">
<tr>
<td><table class="table-in-method" border="0">
<tr>
<td valign="top" colspan="3">void</td>
</tr>
<tr>
<td valign="top"><b>checkPermission</b>(</td>
<td valign="top">[in] any</td>
<td valign="bottom">&nbsp;perm )</td>
</tr>
<tr>
<td valign="top" align="right">raises( </td>
<td valign="top" colspan="2"><a href="AccessControlException.html">AccessControlException</a> );</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>Determines whether the access request indicated by the specified
 permission should be allowed or denied, based on the security policy
 currently in effect.
 The semantics are equivalent to the security permission classes of
 the Java platform.
 </dd>
<dd><p>
 You can also pass a sequence of permissions (sequence< any >) to check
 a set of permissions, e.g. for performance reasons.
 This method quietly returns if the access request is permitted,
 or throws a suitable AccessControlException otherwise.
 </p>
 
 </dd>
<dt><b>Parameter perm</b></dt>
<dd>permission to be checked
 
 </dd>
<dt><b>Throws</b></dt>
<dd>AccessControlException
 thrown if access is denied

 </dd>
<dt><b>See also</b></dt>
<dd><a href="AccessControlException.html">AccessControlException</a>, <a href="AllPermission.html">AllPermission</a>, <a href="RuntimePermission.html">RuntimePermission</a>, ::com::sun::star::<a href="../io/module-ix.html">io</a>::<a href="../io/FilePermission.html">FilePermission</a>, ::com::sun::star::<a href="../connection/module-ix.html">connection</a>::<a href="../connection/SocketPermission.html">SocketPermission</a></dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="doRestricted" class="membertitle">doRestricted</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center">
<tr>
<td><table class="table-in-method" border="0">
<tr>
<td valign="top" colspan="3">any</td>
</tr>
<tr>
<td valign="top"><b>doRestricted</b>(</td>
<td valign="top">[in] <a href="XAction.html">XAction</a></td>
<td valign="bottom">&nbsp;action,</td>
</tr>
<tr>
<td/><td valign="top">[in] <a href="XAccessControlContext.html">XAccessControlContext</a></td>
<td valign="bottom">&nbsp;restriction )</td>
</tr>
<tr>
<td valign="top" align="right">raises( </td>
<td valign="top" colspan="2">::com::sun::star::<a href="../uno/module-ix.html">uno</a>::<a href="../uno/Exception.html">Exception</a> );</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>Perform the specified action restricting permissions to the given
 XAccessControlContext.
 The action is performed with the intersection of the permissions of the currently installed
 XAccessControlContext, the given XAccessControlContext and the security policy currently
 in effect. The latter includes static security, e.g. based on user credentials.
 </dd>
<dd><p>
 If the specified XAccessControlContext is null, then the action is performed
 with unmodified permissions, i.e. the call makes no sense.
 </p>
 
 </dd>
<dt><b>Parameter action</b></dt>
<dd>action object to be executed
 </dd>
<dt><b>Parameter restriction</b></dt>
<dd>access control context to restrict permission; null for no restriction
 </dd>
<dt><b>Returns</b></dt>
<dd>result
 </dd>
<dt><b>Throws</b></dt>
<dd>com::sun::star::uno::Exception
 any UNO exception may be thrown
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="doPrivileged" class="membertitle">doPrivileged</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center">
<tr>
<td><table class="table-in-method" border="0">
<tr>
<td valign="top" colspan="3">any</td>
</tr>
<tr>
<td valign="top"><b>doPrivileged</b>(</td>
<td valign="top">[in] <a href="XAction.html">XAction</a></td>
<td valign="bottom">&nbsp;action,</td>
</tr>
<tr>
<td/><td valign="top">[in] <a href="XAccessControlContext.html">XAccessControlContext</a></td>
<td valign="bottom">&nbsp;restriction )</td>
</tr>
<tr>
<td valign="top" align="right">raises( </td>
<td valign="top" colspan="2">::com::sun::star::<a href="../uno/module-ix.html">uno</a>::<a href="../uno/Exception.html">Exception</a> );</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>Perform the specified action adding a set of permissions defined by the given
 XAccessControlContext.
 The action is performed with the union of the permissions of the currently installed
 XAccessControlContext, the given XAccessControlContext and the security policy currently
 in effect. The latter includes static security, e.g. based on user credentials.
 </dd>
<dd><p>
 If the given XAccessControlContext is null, then the action is performed
 <b>only</b> with the permissions of the security policy currently in effect.
 </p>
 
 @attention
 Do carefully use this method only for well known use-cases to avoid exploits!
 Script engines executing sandboxed scripts should generally deny calling this
 method.
 
 </dd>
<dt><b>Parameter action</b></dt>
<dd>action object to be executed
 </dd>
<dt><b>Parameter restriction</b></dt>
<dd>access control context to restrict permission; null for no restriction
 </dd>
<dt><b>Returns</b></dt>
<dd>result
 </dd>
<dt><b>Throws</b></dt>
<dd>com::sun::star::uno::Exception
 any UNO exception may be thrown
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="getContext" class="membertitle">getContext</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center">
<tr>
<td><table class="table-in-method" border="0">
<tr>
<td valign="top" colspan="3"><a href="XAccessControlContext.html">XAccessControlContext</a></td>
</tr>
<tr>
<td valign="top"><b>getContext</b>();</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>This method takes a "snapshot" of the current calling context
 and returns it.
 </dd>
<dd><p>
 This context may then be checked at a later point, possibly in another thread.
 </p>
 </dd>
<dt><b>Returns</b></dt>
<dd>snapshot of context
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
</table>
<a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright &copy; 2008 Sun Microsystems, Inc.</p>

</div> <!-- id="adc-idlref" -->
</body>

</html>