PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Previous | Contents

PMDF_database_delete_entry

Remove an entry from a database.

VMS FORMAT

status = PMDF_database_delete_entry

(database, entry)

argument information
Argument Data type Access Mechanism
database signed longword read value
entry descriptor read reference

C FORMAT

status = PMDFdatabaseDeleteEntry

(database, entry, entry_len)

argument information 
int PMDFdatabaseDeleteEntry (database, entry, entry_len) 
         int   database; 
         char *entry; 
         int   entry_len;

ARGUMENTS

database

Database to delete the entry from.

entry

Entry to remove from the database (e.g., an alias). Length of this string should not exceed KEY_LENGTH for a short database or LONG_KEY_LENGTH for a long database.

entry_len

Length in bytes of the entry.

DESCRIPTION

Entries are removed from databases with PMDF_database_delete_entry. In the case of duplicate entries, multiple calls are required to remove all entries --- one call per entry. If the specified database is not already opened, then it will be opened automatically. When no more database accesses are to be performed, the database should be closed with PMDF_database_close. See the description of PMDF_database_add_entry for a list of the legal values for database.
Return Values
PMDF__OK Normal, successful completion.
PMDF__BAD Bad parameter value: illegal value specified for database. No entry deleted.
PMDF__NO No matching entry found. No entry deleted.
PMDF__CANOPNDAT Database could not be opened or does not exist.
PMDF__CANTUPDAT Cannot update the database. Attempt to delete an entry failed.
PMDF__ENTWONFIT Length of entry too long for database. No entry deleted.
PMDF__INVSTRDES Invalid string descriptor for entry: descriptor has an invalid value in its DSC$B_CLASS field. No entry deleted.
PMDF__STRTRUERR Supplied string entry is too long. No entry deleted.

Previous | Next | Contents