@OpenAttachedFile

Opens the attached file with attachment number FN FNATTACHMENTNUMBER2 or with the internal (unique) attachment name TEXT TEXTATTACHMENTNAME2 und outputs einen OBJECTFILEHANDLE for it. TEXT MODE3 can be used to specify the open mode.

MODE2:
A=(Append)   Accepted as an option but ignored.
B=(Binary)   No conversion from CR to CRLF or vice versa (always set)
C=(Create)    Accepted as an option but ignored.
E=(Error)   Accepted as an option but ignored.
R=(Read)   Open for reading data (always set)
T=(Text)   Accepted as an option but ignored.
W=(Write)   Accepted as an option but ignored.
Z=(Zero)   Accepted as an option but ignored.
N=(No Cache)   Do not use a cache for this file (this option is ignored for compressed objects)

Example: @OpenAttachedFile(NOTEHANDLE1;FNATTACHMENTNUMBER2;MODE3);

DBHANDLE1:=@OpenDB("TESTDB\\TESTDB1.NSF");
NOTEID:=8450;
NOTEHANDLE1:=@OpenNoteByID(DBHANDLE1;NOTEID;NOTEHANDLE1);

FNATTACHMENTNUMBER2:=1;
MODE3:="RB";
OBJECTFILEHANDLE1:=@OpenAttachedFile(NOTEHANDLE1;FNATTACHMENTNUMBER2;MODE3);

READ_TEXT:=@ReadAttachedFile(OBJECTFILEHANDLE1;"A";10);
@LogReport(READ_TEXT);
OBJECTFILEHANDLE1:=@CloseAttachedFile(OBJECTFILEHANDLE1);

NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
DBHANDLE1:=@CloseDB(DBHANDLE1);

The DB with the OSPATH "TESTDB\\TESTDB1.NSF" opened.
The document with NOTEID 8450 opened.
The first file attachment of this document is opened.
The first 10 bytes of this file attachment are read as TEXT and output in the APILOG output.
The file attachment is closed again.
The document is closed again.
The DB is closed again.

Example: @OpenAttachedFile(NOTEHANDLE1;TEXTATTACHMENTNAME2;MODE3);

DBHANDLE1:=@OpenDB("TESTDB\\TESTDB1.NSF");
NOTEID:=8450;
NOTEHANDLE1:=@OpenNoteByID(DBHANDLE1;NOTEID;NOTEHANDLE1);

TEXTATTACHMENTNAME2:="TEST.DAT";
MODE3:="RB";
OBJECTFILEHANDLE1:=@OpenAttachedFile(NOTEHANDLE1;TEXTATTACHMENTNAME2;MODE3);

READ_TEXT:=@ReadAttachedFile(OBJECTFILEHANDLE1;"A";10);
@LogReport(READ_TEXT);
OBJECTFILEHANDLE1:=@CloseAttachedFile(OBJECTFILEHANDLE1);

NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
DBHANDLE1:=@CloseDB(DBHANDLE1);

The DB with the OSPATH "TESTDB\\TESTDB1.NSF" opened.
The document with NOTEID 8450 opened.
The file attachment named "TEST.DAT" of this document is opened.
The first 10 bytes of this file attachment are read as TEXT and output in the APILOG output.
The file attachment is closed again.
The document is closed again.
The DB is closed again.

Note : This text was machine-translated and may contain inaccuracies.