<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.imap.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.imap-get-quotaroot.php',
    1 => 'imap_get_quotaroot',
    2 => 'Lee los cuotas de cada usuario',
  ),
  'up' => 
  array (
    0 => 'ref.imap.php',
    1 => 'Funciones IMAP',
  ),
  'prev' => 
  array (
    0 => 'function.imap-get-quota.php',
    1 => 'imap_get_quota',
  ),
  'next' => 
  array (
    0 => 'function.imap-getacl.php',
    1 => 'imap_getacl',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/imap/functions/imap-get-quotaroot.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.imap-get-quotaroot" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">imap_get_quotaroot</h1>
  <p class="verinfo">(PHP 4 &gt;= 4.3.0, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">imap_get_quotaroot</span> &mdash; <span class="dc-title">Lee los cuotas de cada usuario</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.imap-get-quotaroot-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>imap_get_quotaroot</strong></span>(<span class="methodparam"><span class="type"><a href="class.imap-connection.php" class="type IMAP\Connection">IMAP\Connection</a></span> <code class="parameter">$imap</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$mailbox</code></span>): <span class="type"><span class="type"><a href="language.types.array.php" class="type array">array</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="para rdfs-comment">
   Recupera los cuotas de cada usuario. El valor límite representa
   el espacio límite asignado para este usuario para el uso de su buzón
   de correo. El valor de uso representa el tamaño actual del buzón
   de correo.
  </p>
 </div>

 <div class="refsect1 parameters" id="refsect1-function.imap-get-quotaroot-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    <dt>
<code class="parameter">imap</code></dt><dd><p class="para">Una instancia de <span class="classname"><a href="class.imap-connection.php" class="classname">IMAP\Connection</a></span>.</p></dd>
    
     <dt><code class="parameter">mailbox</code></dt>
     <dd>
      <p class="para">
       <code class="parameter">mailbox</code> debe ser un nombre de buzón de correo
       (i.e. INBOX).
      </p>
     </dd>
    
   </dl>
  </p>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.imap-get-quotaroot-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Devuelve un array de enteros, conteniendo los cuotas del buzón
   de correo del usuario. Todos los valores son representados
   por una clave basada en el nombre del buzón, y por un array
   representando el nivel de uso y los límites.
  </p>
  <p class="para">
   Esta función devolverá <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si ocurre un error, y
   un array de datos si la respuesta del servidor no pudo ser comprendida.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.imap-get-quotaroot-changelog">
  <h3 class="title">Historial de cambios</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versión</th>
      <th>Descripción</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
 <td>8.1.0</td>
 <td>
  El parámetro <code class="parameter">imap</code> ahora espera una instancia de <span class="classname"><a href="class.imap-connection.php" class="classname">IMAP\Connection</a></span>;
  anteriormente, se esperaba un <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="literal">imap</code> válido.
 </td>
</tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 examples" id="refsect1-function.imap-get-quotaroot-examples">
  <h3 class="title">Ejemplos</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Ejemplo #1 Ejemplo con <span class="function"><strong>imap_get_quotaroot()</strong></span></strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$mbox </span><span style="color: #007700">= </span><span style="color: #0000BB">imap_open</span><span style="color: #007700">(</span><span style="color: #DD0000">"{imap.example.org}"</span><span style="color: #007700">, </span><span style="color: #DD0000">"kalowsky"</span><span style="color: #007700">, </span><span style="color: #DD0000">"password"</span><span style="color: #007700">, </span><span style="color: #0000BB">OP_HALFOPEN</span><span style="color: #007700">)<br />      or die(</span><span style="color: #DD0000">"Conexión imposible : " </span><span style="color: #007700">. </span><span style="color: #0000BB">imap_last_error</span><span style="color: #007700">());<br /><br /></span><span style="color: #0000BB">$quota </span><span style="color: #007700">= </span><span style="color: #0000BB">imap_get_quotaroot</span><span style="color: #007700">(</span><span style="color: #0000BB">$mbox</span><span style="color: #007700">, </span><span style="color: #DD0000">"INBOX"</span><span style="color: #007700">);<br />if (</span><span style="color: #0000BB">is_array</span><span style="color: #007700">(</span><span style="color: #0000BB">$quota</span><span style="color: #007700">)) {<br />   </span><span style="color: #0000BB">$storage </span><span style="color: #007700">= </span><span style="color: #0000BB">$quota</span><span style="color: #007700">[</span><span style="color: #DD0000">'STORAGE'</span><span style="color: #007700">];<br />   echo </span><span style="color: #DD0000">"STORAGE nivel de uso : " </span><span style="color: #007700">.  </span><span style="color: #0000BB">$storage</span><span style="color: #007700">[</span><span style="color: #DD0000">'usage'</span><span style="color: #007700">];<br />   echo </span><span style="color: #DD0000">"STORAGE tamaño límite : " </span><span style="color: #007700">.  </span><span style="color: #0000BB">$storage</span><span style="color: #007700">[</span><span style="color: #DD0000">'limit'</span><span style="color: #007700">];<br /><br />   </span><span style="color: #0000BB">$message </span><span style="color: #007700">= </span><span style="color: #0000BB">$quota</span><span style="color: #007700">[</span><span style="color: #DD0000">'MESSAGE'</span><span style="color: #007700">];<br />   echo </span><span style="color: #DD0000">"MESSAGE nivel de uso : " </span><span style="color: #007700">.  </span><span style="color: #0000BB">$message</span><span style="color: #007700">[</span><span style="color: #DD0000">'usage'</span><span style="color: #007700">];<br />   echo </span><span style="color: #DD0000">"MESSAGE tamaño límite : " </span><span style="color: #007700">.  </span><span style="color: #0000BB">$message</span><span style="color: #007700">[</span><span style="color: #DD0000">'limit'</span><span style="color: #007700">];<br /><br />   </span><span style="color: #FF8000">/* ...  */<br /><br /></span><span style="color: #007700">}<br /><br /></span><span style="color: #0000BB">imap_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$mbox</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
 </div>

 <div class="refsect1 notes" id="refsect1-function.imap-get-quotaroot-notes">
  <h3 class="title">Notas</h3>
  <p class="para">
   Esta función es accesible únicamente a los usuarios de la biblioteca
   c-client2000 o más reciente.
  </p>
  <p class="para">
   <code class="parameter">imap</code> debería ser abierto como el usuario
   cuyo buzón de correo se desea verificar.
  </p>
 </div>

 <div class="refsect1 seealso" id="refsect1-function.imap-get-quotaroot-seealso">
  <h3 class="title">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.imap-open.php" class="function" rel="rdfs-seeAlso">imap_open()</a> - Abre un flujo IMAP hacia un buz&oacute;n de correo</span></li>
    <li><span class="function"><a href="function.imap-set-quota.php" class="function" rel="rdfs-seeAlso">imap_set_quota()</a> - Modifica el cupo de un buz&oacute;n de correo</span></li>
    <li><span class="function"><a href="function.imap-get-quota.php" class="function" rel="rdfs-seeAlso">imap_get_quota()</a> - Lee los cuotas de los buzones de correo as&iacute; como las estad&iacute;sticas sobre cada uno de ellos</span></li>
   </ul>
  </p>
 </div>

</div><?php manual_footer($setup); ?>