NAME
          irReadXferAllow, irReadXferDeny, irResetXferAllow, irResetX-
          ferDeny - open, read, and close the transfer security allow
          and deny tables

     SYNOPSIS
          #include <irapi-ad.h>

          int irReadXferAllow(XFER_TABLE_ENTRY *p_allow_entry)

          int irReadXferDeny(XFER_TABLE_ENTRY *p_deny_entry)

          int irResetXferAllow()

          int irResetXferDeny()

     DESCRIPTION
          These functions allow applications to read the transfer
          security allow and deny tables one entry at a time.

          The irReadXferAllow function reads the transfer security
          allow table sequentially, starting at the first entry.  The
          first call to irReadXferAllow returns the first entry of the
          transfer security allow table and each subsquent call to
          irReadXferAllow returns each subsquent transfer security
          allow based entry.

          irReadXferAllow copys the entry from the transfer security
          allow table into XFER_TABLE_ENTRY variable at address
          p_allow_entry.  The application developer must allocate
          storage for the XFER_TABLE_ENTRY variable.

          The irReadXferDeny function performs the same task as
          irReadXferAllow, but instead of using the transfer security
          allow table, it obtains entry from the transfer security
          deny table.

          The irResetXferAllow and irResetXferDeny functions can be
          used to force the next call to irReadXferAllow and irReadX-
          ferDeny to read the first entry of the transfer security
          allow and deny tables, respectively.

     RETURN VALUE
          IRR_OK is returned if the request is successful.

          IRR_FAIL is returned if an error occurs.

     ERROR
          irError is set as follows if an error occurs:

          IRER_INVALID if an invalid argument is passed in

          IRER_ENDOFTABLE when the end of transfer security table is
          reached

          IRER_SYSERROR if a system error occurred (check irSysError
          for additional information)

     SEE ALSO
          irAddXfer(3IRAPI), irRemoveXfer(3IRAPI),
          irQueryXfer(3IRAPI)

     VERSION
          This is version 11/25/02 of this man page.