Export (0) Print
Expand All

DnsModifyRecordsInSet function

The DnsModifyRecordsInSetfunction adds, modifies or removes a Resource Record (RR) set that may have been previously registered with DNS servers.

Like many DNS functions, the DnsModifyRecordsInSet function type is implemented in multiple forms to facilitate different character encoding. Based on the character encoding involved, use one of the following functions:

  • DnsModifyRecordsInSet_A (_A for ANSI encoding)
  • DnsModifyRecordsInSet_W (_W for Unicode encoding)
  • DnsModifyRecordsInSet_UTF8 (_UTF8 for UTF 8 encoding)

Syntax


DNS_STATUS WINAPI DnsModifyRecordsInSet(
  _In_opt_     PDNS_RECORD pAddRecords,
  _In_opt_     PDNS_RECORD pDeleteRecords,
  _In_         DWORD Options,
  _In_opt_     HANDLE hContext,
  _Inout_opt_  PVOID pExtraList,
  _Inout_opt_  PVOID pReserved
);

Parameters

pAddRecords [in, optional]

A pointer to the DNS_RECORD structure that contains the RRs to be added to the RR set.

pDeleteRecords [in, optional]

A pointer to the DNS_RECORD structure that contains the RRs to be deleted from the RR set.

Options [in]

A value that contains a bitmap of DNS Update Options. Options can be combined and all options override DNS_UPDATE_SECURITY_USE_DEFAULT.

hContext [in, optional]

A handle to the credentials of a specific account. Used when secure dynamic update is required. This parameter is optional.

pExtraList [in, out, optional]

This parameter is reserved for future use and must be set to NULL.

pReserved [in, out, optional]

This parameter is reserved for future use and must be set to NULL.

Return value

Returns success confirmation upon successful completion. Otherwise, it returns the appropriate DNS-specific error code as defined in Winerror.h.

Remarks

The DnsModifyRecordsInSet function type executes in the following steps.

  1. Records specified in pDeleteRecords are deleted. If pDeleteRecords is empty or does not contain records that exist in the current set, the DnsModifyRecordsInSet function goes to the next step.
  2. Records specified in pAddRecords are added. If pAddRecords is empty, the operation completes without adding any records.

To add a new record, provide no records in pDeleteRecords, and provide the record to be added in pAddRecords. To modify a record, specify the record being modified in pDeleteRecords, then add the modified version of that record by placing it in pAddRecords. To delete records, specify only records to be deleted. Multiple records can be added or deleted in a single call to DnsModifyRecordsInSet; however, the value of the pName member in each DNS_RECORD must be the same or the call will fail. If a record specified in pAddRecords is already present, no change occurs.

If no server list is specified, the default name server is queried.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Windns.h

Library

Dnsapi.lib

DLL

Dnsapi.dll

Unicode and ANSI names

DnsModifyRecordsInSet_W (Unicode) and DnsModifyRecordsInSet_A (ANSI)

See also

DnsReplaceRecordSet
DnsQuery
DNS_RECORD

 

 

Community Additions

ADD
Show:
© 2014 Microsoft