DnsReplaceRecordSetW

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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

Parameters

• pNewSet
  [in] Pointer to the DNS_RECORD structure 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 hContext is not obtained by a call to DnsAcquireContextHandle, but is instead a SEC_WINNT_AUTH_IDENTITY_W structure 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

See Also

Reference

DNS Functions

Concepts

TCP/IP and the DNS Client

Other Resources

SEC_WINNT_AUTH_IDENTITY