3.1.4 Message Processing Events and Sequencing Rules
The server MUST indicate to the RPC runtime that it is to perform a strict Network Data Representation (NDR) data consistency check at target level 5.0, as specified in [MS-RPCE] section 3.
Wherever this protocol requires an LDAP operation, if the operation is implemented as an asynchronous LDAP call, the asynchronous result MUST be retrieved prior to returning from the DNS Server Management Protocol operation. The timeout for individual LDAP operations, other than the delete operation, MUST be 180 seconds, and the timeout for LDAP delete operations MUST be 1,440 seconds, unless otherwise stated. LDAP add and modify operations MUST be requested with an asynchronous LDAP method, and the server MUST retry an add or modify operation up to three times if an error prevents submission of the operation, but it MUST NOT retry if the asynchronous result of the operation is unsuccessful. All other operations MUST NOT be retried unless otherwise stated.
Wherever this protocol requires an addition, modification, or deletion of the information in the abstract data model (section 3.1.1), the prescribed operation MUST be performed only on the local in-memory portions of the abstract data model, unless otherwise specified.
Wherever this protocol requires a modification to a DNS Zone Table stored in-memory, the server MUST set the Dirty Flag to TRUE when the modification occurs. Wherever this protocol requires a DNS Zone Table stored in-memory to be written to persistent storage, the server MUST set the Dirty Flag to FALSE upon successful completion of the write.
Opnums 0 through 4 are deprecated. Clients SHOULD<214> use opnums 5 through 9 instead and servers SHOULD support all methods in the table.
This interface includes the following methods in RPC opnum order:
Methods in RPC Opnum Order
|
Method |
Description |
|---|---|
|
Invokes a specified set of server functions. This method is obsoleted by R_DnssrvOperation2 (Opnum 5) (section 3.1.4.6). Opnum: 0 |
|
|
Issues type specific information queries to server. This method is obsoleted by R_DnssrvQuery2 (Opnum 6) (section 3.1.4.7). Opnum: 1 |
|
|
Invokes a specified set of server functions, which return complex structures. This method is obsoleted by R_DnssrvComplexOperation2 (Opnum 7) (section 3.1.4.8). Opnum: 2 |
|
|
Enumerates DNS records on the server. This method is obsoleted by R_DnssrvEnumRecords2 (Opnum 8) (section 3.1.4.9). Opnum: 3 |
|
|
Adds/deletes/modifies DNS records. This method is obsoleted by R_DnssrvUpdateRecord2 (Opnum9) (section 3.1.4.10). Opnum: 4 |
|
|
R_DnssrvOperation2 |
Invokes a specified set of server functions. Opnum: 5 |
|
R_DnssrvQuery2 |
Issues type specific information queries to server. Opnum: 6 |
|
R_DnssrvComplexOperation2 |
Invokes a specified set of server functions, which return complex structures. Opnum: 7 |
|
R_DnssrvEnumRecords2 |
Enumerates DNS records on the server. Opnum: 8 |
|
R_DnssrvUpdateRecord2 |
Adds/deletes/modifies DNS records. Opnum: 9 |
|
Adds, deletes, or modifies DNS records to the zone or zone scope, or cache zone or cache scope (if specified). Opnum: 10 |
|
|
Enumerates DNS records on the server in a particular zone or zone scope, or cache zone or cache scope (if specified). Opnum: 11 |
|
|
Invokes a specified set of server functions. Opnum: 12 |
|
|
Issues type specific information queries to server. Opnum: 13 |
|
|
Invokes a set of server functions specified by the caller. Opnum: 14 |
|
|
Invokes a set of server functions specified by the caller on the virtualization instance. Opnum: 15 |
|
|
Queries the DNS server for information. Opnum: 16 |
|
|
Adds a new DNS record, or modifies or deletes an existing DNS record in a zone or in a zone scope under a virtualization instance. Opnum: 17 |
|
|
Enumerates DNS records on a zone or a zone scope in a virtualization instance. Opnum: 18 |