Platform SDK: Network Management |
The DnsReplaceRecordSet function type replaces an existing record set. Like many DNS functions, the DnsReplaceRecordSet function type is implemented in multiple forms to facilitate different character encoding, which is indicated by a suffix. Based on the character encoding involved, use one of the following functions:
DnsReplaceRecordSetA (_A for ANSI encoding)
DnsReplaceRecordSetW (_W for Unicode encoding)
DnsReplaceRecordSetUTF8 (_UTF8 for UTF 8 encoding)
Notice the lack of an underscore between the function type name and its suffix. If the DnsModifyRecordsInSet function type is called without its suffix (A, W, or UTF8), a compiler error will occur.
DNS_STATUS WINAPI DnsReplaceRecordSet ( PDNS_RECORD pNewSet, DWORD Options, HANDLE hContext, PIP_ARRAY pServerList, PVOID pReserved );
Option | Meaning |
---|---|
DNS_UPDATE_SECURITY_USE_DEFAULT | Uses the default behavior, which is specified in the registry, for secure dynamic DNS updates. |
DNS_UPDATE_SECURITY_OFF | Does not attempt secure dynamic updates. |
DNS_UPDATE_SECURITY_ON | Attempts nonsecure dynamic update. If refused, then attempts secure dynamic update. |
DNS_UPDATE_SECURITY_ONLY | Attempts secure dynamic updates only. |
DNS_UPDATE_CACHE_SECURITY_CONTEXT | Caches the security context for use in future transactions. |
DNS_UPDATE_TEST_USE_LOCAL_SYS_ACCT | Uses credentials of the local computer account. |
DNS_UPDATE_FORCE_SECURITY_NEGO | Does not use cached security context. |
DNS_UPDATE_RESERVED | Reserved for future use. |
Returns success confirmation upon successful completion. Otherwise, returns the appropriate DNS-specific error code as defined in Winerror.h.
Windows NT/2000: Requires Windows 2000.
Header: Declared in Windns.h.
Library: Use Dnsapi.lib.