3.3.3 diskheap_label_get_entry -- Get a specific entry from the label array.

Function:

int diskheap_label_get_entry(diskheap_t * diskheap_p, const unsigned int entry_n, char **label_p, unsigned int * block_num_p, unsigned int * offset_p);

Usage: ret = diskheap_label_get_entry(diskheap_p, 1 /* entry number */, &label_p, &block_num, &offset);

There are a certain number (currently 10) of label and location associations stored in the diskheap header. This function gets a specific entry and returns the label string and the associated block-number and offset location. It will return DISKHEAP_ERROR_NONE if it succeeds otherwise an error code.

NOTE: The label_p string pointer argument must be passed to free to be deallocated.

Go to the first, previous, next, last section, table of contents.

Diskheap Home Page. Copyright 2002 by Gray Watson