DnsAcquireContextHandle_A函式 （windns.h）
DnsAcquireContextHandle 函式類型會取得一組認證的內容句柄。 和許多 DNS 函式一樣，DnsAcquireContextHandle 函式類型是以多個形式實作，以利不同的字元編碼。 根據所涉及的字元編碼方式，使用下列其中一個函式：
- DnsAcquireContextHandle_A （ANSI 編碼_A）
- DnsAcquireContextHandle_W （Unicode 編碼的_W）
語法
DNS_STATUS DnsAcquireContextHandle_A(
[in] DWORD CredentialFlags,
[in, optional] PVOID Credentials,
[out] PHANDLE pContext
);
參數
[in] CredentialFlags
表示字元編碼的旗標。 設定為 UNIcode 的 TRUE 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 |