DnsAcquireContextHandle_W函数 (windns.h)
DnsAcquireContextHandle 函数类型获取一组凭据的上下文句柄。 与许多 DNS 函数一样,DnsAcquireContextHandle 函数类型以多种形式实现,以促进不同的字符编码。 根据涉及的字符编码,使用以下函数之一:
- DnsAcquireContextHandle_A(ANSI 编码_A)
- DnsAcquireContextHandle_W (Unicode 编码_W)
语法
DNS_STATUS DnsAcquireContextHandle_W(
[in] DWORD CredentialFlags,
[in, optional] PVOID Credentials,
[out] PHANDLE pContext
);
参数
[in] CredentialFlags
指示字符编码的标志。 设置为 Unicode TRUE,ANSI 的 FALSE。
[in, optional] Credentials
指向 SEC_WINNT_AUTH_IDENTITY_W 结构或 SEC_WINNT_AUTH_IDENTITY_A 结构的指针,该结构包含要用于安全动态更新的帐户的名称、域和密码。 如果将 CredentialFlags 设置为 true,凭据 指向 SEC_WINNT_AUTH_IDENTITY_W 结构;否则,凭据 指向 SEC_WINNT_AUTH_IDENTITY_A 结构。 如果未指定,则使用调用服务的凭据。 此参数是可选的。
[out] pContext
指向指向返回凭据的句柄的指针。
返回值
返回成功完成后的成功确认。 否则,返回 Winerror.h 中定义的相应 DNS 特定错误代码。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | 窗户 |
标头 | windns.h |
库 | Dnsapi.lib |
DLL | Dnsapi.dll |