AddAssociatedFileFromFile

Associated files, attachments, file input

Description

Embeds a file once, adds it to the /EmbeddedFiles name tree, and registers the same file specification in the document catalog /AF array

An empty DisplayName uses the source file name without its directory path

Syntax

Delphi and ActiveX

Function AddAssociatedFileFromFile(Const FileName, DisplayName, MIMEType, Description, Relationship: WideString): Integer;

DLL

int DLAddAssociatedFileFromFile(int InstanceID, const wchar_t* FileName, const wchar_t* DisplayName, const wchar_t* MIMEType, const wchar_t* Description, const wchar_t* Relationship)

Return value

Returns a nonzero embedded-file handle on success or 0 when validation or input fails

Remarks

Relationship must be Source, Data, Alternative, Supplement, or Unspecified

Associated files require PDF 1.7 and are rejected by PDF/A profiles that forbid embedded files