DnsAcquireContextHandle_A函式 (windns.h)
DnsAcquireContextHandle 函式類型會取得一組認證的內容句柄。 就像許多 DNS 函式一樣， DnsAcquireContextHandle 函式類型會以多個形式實作，以利不同的字元編碼。 根據所涉及的字元編碼，使用下列其中一個函式：
- ANSI 編碼) 的 DnsAcquireContextHandle_A (_A
- unicode 編碼) 的 DnsAcquireContextHandle_W (_W
語法
DNS_STATUS DnsAcquireContextHandle_A(
[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 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | windns.h |
| 程式庫 | Dnsapi.lib |
| Dll | Dnsapi.dll |