tfDnsUpdateZone

Table of Contents >> Application Reference >> Dynamic DNS Update

#include <trsocket.h>

int tfDnsUpdateZone	(
	ttDnsUpdateHandle dnsUpdateHandle,
	const char * zoneNamePtr)
	);

Function Description

Set the name of the zone that you are updating. The zone name is typically all labels after the first label of a domain name (e.g. www.example.com is in zone example.com). The zone name is sent to the DNS server as part of the request. If you do not provide a zone name, Treck will attempt to derive the zone name from the domain name you specify in your first call to tfDnsUpdateAdd() or tfDnsUpdateDelete().

After a successful call to tfDnsUpdateSend(), you may call tfDnsUpdateZone() to change the zone name prior to building another update request (the DNS server specified in tfDnsUpdateOpen() must be authoritative for the zone).

Parameters

• dnsUpdateHandle

  A DNS update descriptor handle returned by tfDnsUpdateOpen().

• zoneNamePtr

  The name of the zone to update.

Returns

• TM_ENOERROR

  Success.

• TM_EINVAL

  Invalid descriptor handle or zoneNamePtr is NULL.

• TM_EPERM

  Cannot change the descriptor while tfDnsUpdateSend() is in progress.

Table of Contents >> Application Reference >> Dynamic DNS Update