Fungsi DsBindWithSpnW (ntdsapi.h)

Artikel
11/20/2024

Fungsi DsBindWithSpn mengikat pengontrol domain menggunakan kredensial yang ditentukan dan nama perwakilan layanan (SPN) tertentu untuk autentikasi bersama.

Fungsi ini disediakan di mana kontrol lengkap diperlukan untuk autentikasi bersama. Jangan gunakan fungsi ini jika Anda mengharapkan DsBind menemukan server untuk Anda, karena SPN khusus komputer, dan tidak mungkin SPN yang Anda berikan akan cocok dengan server yang DsBind temukan untuk Anda. Menyediakan argumen ServicePrincipalNameNULL menghasilkan perilaku yang identik dengan DsBindWithCred.

Sintaksis

NTDSAPI DWORD DsBindWithSpnW(
  [in, optional] LPCWSTR                  DomainControllerName,
  [in, optional] LPCWSTR                  DnsDomainName,
  [in, optional] RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
  [in, optional] LPCWSTR                  ServicePrincipalName,
  [out]          HANDLE                   *phDS
);

Parameter

[in, optional] DomainControllerName

Penunjuk ke string null-terminated yang berisi nama DNS domain yang sepenuhnya memenuhi syarat untuk diikat. Untuk informasi selengkapnya, lihat deskripsi DomainControllerName dalam topik DsBind.

[in, optional] DnsDomainName

Penunjuk ke string null-terminated yang berisi nama DNS domain yang sepenuhnya memenuhi syarat untuk diikat. Untuk informasi selengkapnya, lihat deskripsi DnsDomainName dalam topik DsBind.

[in, optional] AuthIdentity

Berisi nilai RPC_AUTH_IDENTITY_HANDLE yang mewakili kredensial yang akan digunakan untuk pengikatan. Si

fungsi DsMakePasswordCredentials digunakan untuk mendapatkan nilai ini. Jika parameter ini NULL, kredensial utas panggilan digunakan.

DsUnBind harus dipanggil sebelum membebaskan handel ini dengan fungsi DsFreePasswordCredentials .

[in, optional] ServicePrincipalName

Penunjuk ke string null-terminated yang menentukan Nama Perwakilan Layanan untuk ditetapkan ke klien. Meneruskan NULL di ServicePrincipalName setara dengan panggilan ke fungsi DsBindWithCred.

[out] phDS

Alamat nilai HANDLE yang menerima handel pengikatan. Untuk menutup handel ini, teruskan ke fungsi DsUnBind.

Mengembalikan nilai

Mengembalikan ERROR_SUCCESS jika berhasil atau kode kesalahan Windows atau RPC jika tidak. Berikut ini adalah kode kesalahan yang paling umum.

Komentar

Nota

Header ntdsapi.h mendefinisikan DsBindWithSpn sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista
server minimum yang didukung	Windows Server 2008
Platform Target	Windows
Header	ntdsapi.h
Pustaka	Ntdsapi.lib
DLL	Ntdsapi.dll

Lihat juga

Fungsi Pengendali Domain dan Manajemen Replikasi

DsBind

DsBindWithCred

DsUnBind

Bagikan melalui