Platform SDK: Network Management |
The DnsAcquireContextHandle function type acquires a context handle to a set of credentials. Like many DNS functions, the DnsAcquireContextHandle function type is implemented in multiple forms to facilitate different character encoding. Based on the character encoding involved, use one of the following functions:
DnsAcquireContextHandle_A (_A for ANSI encoding)
DnsAcquireContextHandle_W (_W for Unicode encoding)
If the DnsAcquireContextHandle function type is called without its suffix (_A or _W), a compiler error will occur.
DNS_STATUS WINAPI DnsAcquireContextHandle( DWORD CredentialFlags, PVOID Credentials, HANDLE *ContextHandle );
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.