DNSAddAddress (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / DNS functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

DNSAddAddress (Function)

In french: DNSAjouteAdresse

Adds an "IP address/domain name" pair to the DNS server.

Example

c is Duration
c.InDays = 1
ResultDNS is boolean

// Ajout d'une une relation "Adresse IP/Nom de domaine" dans un serveur DNS spécifique
ResultDNS = DNSAddAddress("testdoc.doc.local.", "192.168.1.1", c, "Andromede_2")
IF ResultDNS = False THEN
	Error(ErrorInfo(errFullDetails))
END

// Ajout d'une une relation "Adresse IP/Nom de domaine" dans le serveur DNS par défaut
ResultDNS = DNSAddAddress("testAp.towerqual.local.", "192.168.1.2")
IF ResultDNS = False THEN
	Error(ErrorInfo(errFullDetails))
END

Syntax

<Result> = DNSAddAddress(<Domain name> , <IP address> [, <Validity period> [, <DNS server> [, <User> [, <Password>]]]])

<Result>: Boolean

True if the DNS address was successfully added,
False otherwise. ErrorInfo returns more information on the error.

<Domain name>: Unicode string

Full domain name to be associated with the IP address. This parameter has the following format:
<Nom> + "." + <Domaine>
For example: "testdoc.windev.com"

<IP address>: Character string

IP address to be associated with <Domain name>. It can be an Internet Protocol version 4 (in the xxx.xxx.xxx.xxx format) or version 6 (in the aaaa:bbbb:cccc:dddd:eeee:ffff:gggg:hhhh:iiii:jjjj format).

<Validity period>: Optional duration

Duration (in seconds) of the request validity. This parameter can correspond to:
an integer corresponding to the number of seconds,
a Duration variable,
the duration in a readable format (e.g., 1 s).
This parameter is set to 0 by default.

<DNS server>: Optional character string

Address of the DNS server to be updated. The "IP address/domain name" pair will be added to this server. By default, the current DNS server is used.

<User>: Optional Unicode character string

Name of the user used to sign the request.

<Password>: Optional Unicode string or Secret string

Password associated with the user to sign the request.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.

Remarks

This function supports Linux and Windows DNS servers that do not require signed requests.
This function supports Linux and Windows DSN servers that require signed requests.

Component: wd300com.dll