hw_api::object

(PHP 4, PHP 5 < 5.2.0, PECL hwapi SVN)

hw_api::object — Recupera información de los atributos de un objeto

Descripción

hw_api::object ( array $parameter ) : hw_api_object

Esta función recupera la información de los atributos de un objeto de cualquier versión. No devolverá el contenido del documento.

Parámetros

parameter

El parámetro es un array que contiene el elemento obligatorio 'objectIdentifier' y los elementos opcionales 'attributeSelector' y 'version'.

Valores devueltos

El objeto devuelto es una instancia de la clase HW_API_Object en caso de éxito o HW_API_Error en caso de error.

Ejemplos

Este ejemplo simple recupera un objeto y verifica si ha habido errores.

Ejemplo #1 Recupera un objeto

<?php
function handle_error($error)
{
  $reason = $error->reason(0);
  echo "Type: <b>";
  switch ($reason->type()) {
    case 0:
      echo "Error";
      break;
    case 1:
      echo "Warning";
      break;
    case 2:
      echo "Message";
      break;
  }
  echo "</b><br />\n";
  echo "Description: " . $reason->description("en") . "<br />\n";
}

function list_attr($obj)
{
  echo "<table>\n";
  $count = $obj->count();
  for ($i=0; $i<$count; $i++) {
    $attr = $obj->attribute($i);
    printf("<tr><td align=\"right\" bgcolor=\"#c0c0c0\"><b>%s</b></td><td bgcolor=\"#F0F0F0\">%s</td></tr>\n",
             $attr->key(), $attr->value());
  }
  echo "</table>\n";
}

$hwapi = hwapi_hgcsp($g_config[HOSTNAME]);
$parms = array("objectIdentifier"=>"rootcollection", "attributeSelector"=>array("Title", "Name", "DocumentType"));
$root = $hwapi->object($parms);
if (get_class($root) == "HW_API_Error") {
  handle_error($root);
  exit;
}
list_attr($root);
?>

Ver también