2.2.5.2.2 DNS_RPC_ZONE_FLAGS

The DNS_RPC_ZONE_FLAGS is a bit-mask value used by the DNS_RPC_ZONE structure (section 2.2.5.2.1) to indicate zone properties and state.

This type is declared as follows:

 typedef DWORD DNS_RPC_ZONE_FLAGS, *PDNS_RPC_ZONE_FLAGS;

Figure 5: DNS_RPC_ZONE_FLAGS Bit-Mask

A (Paused): If set to 1, indicates that this zone is currently administratively paused. The DNS server will not use this zone to respond to queries, will not accept updates in this zone, and will suspend all other functions related to this zone. The default value for this flag is 0.

B (Shutdown): If set to 1, indicates that an error occurred that caused the DNS server to be unable to load a complete copy of the zone into memory. For primary zones, the DNS server MUST set this flag to 1 if an error occurred while loading the zone or its records from persistent storage. If the zone is directory server-integrated, the DNS server MUST retry loading the zone at an interval specified by the DsPollingInterval property (section 3.1.1.1) and set this flag to zero if a subsequent loading attempt succeeds. If the server is not directory server-integrated the DNS server MUST NOT automatically retry loading the zone. For secondary and stub zones, the DNS server MUST set this flag to 1 if zone transfer was refused by all of the master servers or if zone transfer could not be successfully completed. The DNS server MUST retry zone transfer as specified by [RFC1034] and set this flag to zero if a subsequent zone transfer attempt succeeds. The default value of this field MUST be 1 and the value MUST be set to zero if the zone is successfully loaded during initialization (section 3.1.3).

C (Reverse): If set to 1, indicates that this is a reverse lookup zone.

D (AutoCreated): If set to 1, indicates that zone was auto-created. A DNS server MAY automatically create certain zones at boot time or when a virtualization instance is created via the CreateVirtualizationInstance RPC operation (section 3.1.4.1), and flag these zones as "AutoCreated". Such zones are never written to persistent storage, and the DNS Server MUST NOT perform any DNS Server Management Protocol RPC operations on such zones.<39>

E (DsIntegrated): If set to 1, indicates that zone is stored in a directory server.

F (Aging): If set to 1, indicates that zone has aging enabled for resource records.

G (Update): The type of updates that are supported on this zone. This value MUST be set to one of the possible value from DNS_ZONE_UPDATE (section 2.2.6.1.1).

H (ReadOnly): If set to 1, indicates that this zone is operating in read-only mode. The DNS server SHOULD<40> support read-only zones. If the DNS server supports read-only zones, it MUST set this flag to 1 if the zone is loaded from a directory server that is read-only, and in all other cases it MUST set the flag to 0.

I (Unused): MUST be set to zero when sent and MUST be ignored on receipt.