File Content Extraction 25.4
Filter SDK C Programming Guide

# fpFree()

Frees the resources associated with a KVMetadataList structure.

## Syntax

    void pascal  fpFree(const struct KVMetadataList* const pMetadata);

## Arguments

`pMetadata` | A pointer to a KVMetadataList that you obtained by calling fpGetMetadataList() or fpGetSubFileMetadataList(). This must be the same `KVMetadataList` pointer that you are calling `fpFree()` on.

## Lifetime and Memory Management

After the `KVMetadataList` pointer has been freed, it is no longer valid, and should be set to NULL. You must not call any function on a `KVMetadataList` pointer that has been freed.

After the `KVMetadataList` pointer has been freed, any `KVMetadataElements` obtained by calling fpGetNext() on that pointer are also invalid, and you must not access them.

## Discussion

You can call `fpFree()` before all metadata elements have been obtained by calling fpGetNext() or fpFindKey().

Copyright 1997-2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: File Content Extraction 25.4

Topic Title: fpFree()