HAddLink (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

HFSQL Client/Server functions

HAddScheduledOptimization

HCS.FrameSize (Variable)

HCS.Timeout (Variable)

HDeleteScheduledBackup

HDeleteScheduledOptimization

HExecuteScheduledBackup

HExecuteScheduling

HInfoBackup

HInfoDatabaseProperty

HInfoDatabaseRights (Example)

HInfoDatabaseRights

HInfoFileProperty

HInfoFileRights (Example)

HInfoServerRights (Example)

HListScheduledOptimization

HModifyDatabaseProperty

HModifyDatabaseRights

HModifyFileProperty

HModifyFileRights

HModifyGroup

HModifyScheduledBackup

HModifyScheduledOptimization

HModifyScheduling

HModifyServerProperty

HNotifAddEmailRecipient

HNotifConfigure

HNotifDeleteCCRecipient

HNotifDeleteEmailRecipient

HNotifListCCRecipient

HNotifListEmailRecipient

HRestoreBackup (Example)

Link description
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HAddLink (Function)

In french: HAjouteLiaison

Available only with this kind of connection

Adds an integrity rule between two data files on the server. This integrity rule has been previously described by a variable of type Link description. All the client applications must comply with these integrity rules.

Remark: You have the ability to describe inter-database integrity rules.

The addition will be effective for the application that performed it once the connection has been closed and re-opened.

Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Versions 22 and later

This function is now available in Universal Windows 10 App mode.

New in version 22

This function is now available in Universal Windows 10 App mode.

Versions 24 and later

This function is now available for iPhone/iPad applications.

New in version 24

This function is now available for iPhone/iPad applications.

Example

// Describe the connection
HDescribeConnection("MyConnection", "Julia", "Password", "MyHFServer", ...
"MyDatabase", hAccessHFClientServer, hORead)
// Open the connection
HOpenConnection("MyConnection")
...
MyLink is Link Description
// Describe the "LIVES" link
MyLink.Name = "LIVES"
MyLink.SourceFile = ".\MyDatabase\city.fic"
MyLink.LinkedFile = ".\MyDatabase\customer.fic"
MyLink.SourceKey = "CITYNAME"
MyLink.LinkedKey = "CUSTCITY"
// Default link (0-1, 0-1)
HAddLink("MyConnection", MyLink)

Syntax

<Result> = HAddLink(<Source connection> [, <Linked connection>] , <Link>)

<Result>: Boolean

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

<Source connection>: Character string or Connection variable

Connection to which belongs the source file of the link. This connection corresponds to:
the name of the connection defined in the data model editor or with HDescribeConnection or HOpenConnection.
a variable of type Connection.

<Linked connection>: Optional character string or Connection variable

Connection to which belongs the linked file of the link. This connection corresponds to:
the connection defined in the data model editor or with HDescribeConnection or HOpenConnection.
a variable of type Connection.
If this parameter is not specified, both data files will belong to the same connection (<Source connection>).

<Link>: Link Description variable

Name of the Link description variable containing the characteristics of the link to create.

Remarks

Link description

In the link description, the names of the data files involved in the link (SourceFile and LinkedFile properties) must correspond to the physical names of the data files, relative to the Database used. The Database of each file is returned by <Source connection> and <Linked connection>

Miscellaneous

HDescribeLink is used to describe a temporary link on an ISAM database (not in Client/Server mode) or for the client application only (not on the server).
HDeleteLink is used to delete a link on the server.

Versions 27 and later
HFSQL cluster: HAddLink can be used with HFSQL clusters.
New in version 27
HFSQL cluster: HAddLink can be used with HFSQL clusters.
HFSQL cluster: HAddLink can be used with HFSQL clusters.

Component: wd270hf.dll