File Content Extraction 26.1
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 26.1 | Last updated January 2026

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 26.1

Topic Title: fpFree()