fungsi DnsAcquireContextHandle_A (windns.h)
Jenis fungsi DnsAcquireContextHandle memperoleh handel konteks ke sekumpulan kredensial. Seperti banyak fungsi DNS, jenis fungsi DnsAcquireContextHandle diimplementasikan dalam beberapa bentuk untuk memfasilitasi pengodean karakter yang berbeda. Berdasarkan pengodean karakter yang terlibat, gunakan salah satu fungsi berikut:
- DnsAcquireContextHandle_A (_A untuk pengodean ANSI)
- DnsAcquireContextHandle_W (_W untuk pengodean Unicode)
Sintaks
DNS_STATUS DnsAcquireContextHandle_A(
[in] DWORD CredentialFlags,
[in, optional] PVOID Credentials,
[out] PHANDLE pContext
);
Parameter
[in] CredentialFlags
Bendera yang menunjukkan pengodean karakter. Atur ke TRUE untuk Unicode, FALSE untuk ANSI.
[in, optional] Credentials
Penunjuk ke struktur SEC_WINNT_AUTH_IDENTITY_W atau struktur SEC_WINNT_AUTH_IDENTITY_A yang berisi nama, domain, dan kata sandi akun yang akan digunakan dalam pembaruan dinamis yang aman. Jika CredentialFlags diatur ke TRUE, Kredensial menunjuk ke struktur SEC_WINNT_AUTH_IDENTITY_W ; jika tidak, Kredensial menunjuk ke struktur SEC_WINNT_AUTH_IDENTITY_A . Jika tidak ditentukan, kredensial layanan panggilan digunakan. Parameter ini bersifat opsional.
[out] pContext
Penunjuk ke handel yang menunjuk ke kredensial yang dikembalikan.
Mengembalikan nilai
Mengembalikan konfirmasi keberhasilan setelah berhasil diselesaikan. Jika tidak, mengembalikan kode kesalahan khusus DNS yang sesuai seperti yang didefinisikan dalam Winerror.h.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | windns.h |
| Pustaka | Dnsapi.lib |
| DLL | Dnsapi.dll |