THotPDF.GetLoadedEmbeddedFileSpec Method
Finds an embedded file specification dictionary by filename in the currently loaded PDF document. Use it before extracting embedded payload bytes or validating associated-file metadata
Declaration
function GetLoadedEmbeddedFileSpec(const AFileName: AnsiString): THPDFDictionaryObject;Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
AFileName | Embedded file name as stored in the loaded document name tree |
Return value
Returns the loaded embedded file specification dictionary, or nil when no match is found
Usage notes
- The lookup supports direct /Names arrays and nested /Kids name-tree nodes
- The returned dictionary belongs to the loaded document object graph and must not be freed by caller code
- Use ExtractEmbeddedFileBytes when only the payload bytes are needed