int aw_object_delete (void)

DESCRIPTION

Deletes an object.

CALLBACK

AW_CALLBACK_OBJECT_RESULT

NOTES

The object to be deleted is uniquely identified by the attributes AW_OBJECT_X, AW_OBJECT_Z, and AW_OBJECT_NUMBER.

For aw_object_delete to succeed, the instance must either own the object or have the EMINENT DOMAIN right.

If you have the callback AW_CALLBACK_OBJECT_RESULT installed, AW_OBJECT_NUMBER will be set during the callback to indicate which object the callback is for.  This can be useful in applications that issue multiple asynchronous building requests.

EXAMPLE

void delete_object (int x, int z, int number)
{

  int		rc;

  aw_int_set (AW_OBJECT_NUMBER, number);
  aw_int_set (AW_OBJECT_X, x);
  aw_int_set (AW_OBJECT_Z, z);
  if (rc = aw_object_delete ())
    printf ("Unable to delete object (reason %d)\n", rc);
  else
    puts ("Object deleted");

}

SEE ALSO

aw_delete_all_objects
aw_object_add
aw_object_change
aw_object_load