HExtractMemo (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / Managing databases / HFSQL / HFSQL functions

Binary Memo item that uses HFSQL thumbnails
Managing memos in SQLite
Previous versions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HExtractMemo (Function)

In french: HExtraitMémo

Not available with this kind of connection

Extracts the content of a binary memo item from an HFSQL data file, from a query or from an HFSQL view into a physical file (on disk).

Example

See additional examples

HExtractMemo(Customer, Photo, "C:\temp\Photo.gif")

// Product image
IF HExtractMemo(SQLGetMemo("MyQuery", 2), "Product.BMP") = False THEN
	RETURN False
END

Syntax

Extracting a memo Hide the details

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

<Result>: Boolean

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

<Data file>: Character string

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 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.

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 uses 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: wd300hf.dll