HExtractMemo (Function)

Name of data file (query of view) used. If this name is not specified, HExtractMemo will use the last data file used by the last HFSQL function (function starting with "H").

<Memo item>: Character string

Name of the item containing the binary memo to extract.

<Destination file>: Optional character string

Path and full name of the file where the content of the item must be saved. If this parameter is not specified, the binary memo is saved in its initial path and file. The creation date and the date of last modification of this file are restored.
This parameter is mandatory because the name of the source file is not saved in the OLE DB memos.
This parameter must necessarily be specified.

Extracting a memo (syntax for SQLGetMemo) Hide the details

<Result> = HExtractMemo(<Binary Memo> , <Destination file>)

<Result>: Boolean

True if the operation was performed,
False if a problem occurs. HError is used to identify the error.

<Binary Memo>: Character string

Binary memo returned by SQLGetMemo.

<Destination file>: Character string

Path and full name of the file where the content of the item must be saved.
This parameter is mandatory because the name of the source file is not saved in the OLE DB memos.

Versions 19 and later

Extracting a memo from a Record variable Hide the details

<Result> = HExtractMemo(<Memo item> [, <Destination file>])

<Result>: Boolean

True if the operation was performed,
False if a problem occurs. HError is used to identify the error.

<Memo item>: Record variable

Name of the item containing the binary memo to extract. Use the following notation: <Name of Record variable>.<Name of Memo item>.

<Destination file>: Optional character string

Path and full name of the file where the content of the item must be saved. If this parameter is not specified, the binary memo is saved in its initial path and file. The creation date and the date of last modification of this file are restored.
This parameter is mandatory because the name of the source file is not saved in the OLE DB memos.

New in version 19

Extracting a memo from a Record variable Hide the details

<Result> = HExtractMemo(<Memo item> [, <Destination file>])

<Result>: Boolean

True if the operation was performed,
False if a problem occurs. HError is used to identify the error.

<Memo item>: Record variable

Name of the item containing the binary memo to extract. Use the following notation: <Name of Record variable>.<Name of Memo item>.

<Destination file>: Optional character string

Path and full name of the file where the content of the item must be saved. If this parameter is not specified, the binary memo is saved in its initial path and file. The creation date and the date of last modification of this file are restored.
This parameter is mandatory because the name of the source file is not saved in the OLE DB memos.

Extracting a memo from a Record variable Hide the details

<Result> = HExtractMemo(<Memo item> [, <Destination file>])

<Result>: Boolean

True if the operation was performed,
False if a problem occurs. HError is used to identify the error.

<Memo item>: Record variable

Name of the item containing the binary memo to extract. Use the following notation: <Name of Record variable>.<Name of Memo item>.

<Destination file>: Optional character string

Path and full name of the file where the content of the item must be saved. If this parameter is not specified, the binary memo is saved in its initial path and file. The creation date and the date of last modification of this file are restored.
This parameter is mandatory because the name of the source file is not saved in the OLE DB memos.

Remarks

Binary Memo item that is using HFSQL thumbnails

To extract the content of an HFSQL thumbnail from an HFSQL item, use Thumbnail.

For more details, see HFSQL thumbnails.

Managing memos in SQLite

Storing information in memo format is recommended for the data whose size is less than 1 MB. We advise you to directly save the data in external file format on the internal or external memory of the phone and to store the access path to this data in the database.

Previous versions

This function replaces BinarySave, which is kept for compatibility with WINDEV 5.5.

Component: wd270hf.dll