AgeAllRecords method of the MicrosoftDNS_Zone class

Article
12/11/2020

The AgeAllRecords method enables aging for some or all non-NS and non-SOA records in a zone.

Syntax

uint32 AgeAllRecords(
  [in, optional] string  NodeName,
  [in, optional] boolean ApplyToSubtree
);

Parameters

NodeName [in, optional]: Name of the node to age.
ApplyToSubtree [in, optional]: Specifies whether aging should apply to all records in the subtree. Set to TRUE to apply aging to all records in the subtree, beginning with NodeName.

Return value

ERROR_SUCCESS indicates the aging was successfully completed. Any other value is an error code.

Remarks

If NodeName is not specified, all records will be subject to aging and scavenging.

If NodeName is specified and ApplyToSubtree is not specified or set to zero, records at the specified node will be subjected to aging and scavenging.

If NodeName is specified and ApplyToSubtree is set to 1, all records of the subtree starting at NodeName will be subjected to aging and scavenging. The time stamp is set to the current time for all non-NS and non-SOA RRs with the owner name(s) identified by the input parameters.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows 2000 Server [desktop apps only]
Namespace	Root\MicrosoftDNS
MOF	Dnsprov.mof