Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function replaces an existing record set. Windows Embedded CE supports the Unicode encoding, as indicated by the *_Wsuffix.

Syntax 

DNS_STATUS WINAPI DnsReplaceRecordSetW(
  PDNS_RECORD 
pNewSet,
  DWORD 
Options,
  HANDLE 
hContext,
  PIP_ARRAY 
pServerList,
  PVOID 
pReserved
);

Parameters

pNewSet

[in] Pointer to the DNS_RECORDstructure holding the resource record set that replaces the existing set. The specified resource record set is replaced with the contents of pNewSet.

Options

[in] Options to apply to the operation. The following table shows available options, which can be combined.

Option Description

DNS_UPDATE_SECURITY_OFF

Does not attempt secure dynamic updates if names cannot be registered anonymously. This is the default setting.

DNS_UPDATE_SECURITY_ON

Attempts nonsecure dynamic update. If refused, then attempts secure dynamic update.

DNS_UPDATE_SECURITY_ONLY

Attempts secure dynamic updates only. Does not attempt anonymous name registration.
hContext

[in] Handle to the credentials of a specific account. This is used when secure dynamic update is required. This parameter is optional. For more information, see the Remarks section.

pServerList

[in] Pointer to the array of DNS server IP addresses to which the Find Authoritative Zone (FAZ) request is sent. Windows Embedded CE supports a maximum of one server listed in this parameter. Attempts to specify multiple DNS servers result in failure.

pReserved

Reserved for future use.

Return Value

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

Remarks

On Windows Embedded CE, this hContextis not obtained by a call to DnsAcquireContextHandle, but is instead a SEC_WINNT_AUTH_IDENTITY_Wstructure filled with the appropriate settings and typecasted to be a HANDLE.

Security Note:
Because hContext might contain a user password, name, and domain information, calling functions should clear hContext when the data is no longer required.

Unlike desktop versions of Windows, Windows Embedded CE does not have a registry key that sets the default security in authentication and that is used through DNS_UPDATE_SECURITY_USE_DEFAULT.

Requirements

Header windns.h
Library dnsapi.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also