The Modify method updates a Start Of Authority (SOA) Resource Record.
Syntax
void Modify(
[in, optional] uint32 TTL,
[in, optional] uint32 SerialNumber,
[in, optional] string PrimaryServer,
[in, optional] string ResponsibleParty,
[in, optional] uint32 RefreshInterval,
[in, optional] uint32 RetryDelay,
[in, optional] uint32 ExpireLimit,
[in, optional] uint32 MinimumTTL,
[out, ref] MicrosoftDNS_SOAType &RR
);
Parameters
TTL [in, optional]
Time, in seconds, that the RR can be cached by a DNS resolver.
SerialNumber [in, optional]
SOA serial number representing the number of times the zone has been updated, used by secondary servers to determine whether zone transfer is necessary.
PrimaryServer [in, optional]
Name of the primary server.
ResponsibleParty [in, optional]
Mailbox address of the responsible party, in the form of alias.domain, such as xyz.microsoft.com. Note the use of a period rather than an at symbol (@).
RefreshInterval [in, optional]
Time, in seconds, before the zone containing this record should be refreshed.
RetryDelay [in, optional]
Time, in seconds, the DNS Server should delay between name resolution attempts.
ExpireLimit [in, optional]
Time, in seconds, that secondary servers should wait for a response from the primary server before discarding their copies of the zone file as invalid.
MinimumTTL [in, optional]
TTL time, in seconds, applied to resource records in the zone that do not specify their own TTL.
RR [out, ref]
Reference to the modified object
Return value
This method does not return a value.
Remarks
Any parameter not specified is left unchanged in the modified record.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Namespace | Root\MicrosoftDNS |
| MOF | Dnsprov.mof |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
