Fungsi DsServerRegisterSpnA (ntdsapi.h)
Fungsi DsServerRegisterSpn menyusun dua SPN untuk layanan berbasis host. Nama didasarkan pada nama DNS dan NetBIOS dari komputer lokal. Fungsi memodifikasi atribut servicePrincipalName dari akun tertentu atau akun yang terkait dengan utas panggilan. Fungsi ini mendaftarkan atau membatalkan pendaftaran SPN.
Layanan berbasis host adalah instans layanan yang menyediakan layanan yang diidentifikasi dengan komputer hostnya, seperti yang dibedakan dari layanan yang dapat direplikasi di mana klien tidak memiliki preferensi komputer host mana instans layanan berjalan.
Sintaks
NTDSAPI DWORD DsServerRegisterSpnA(
[in] DS_SPN_WRITE_OP Operation,
[in] LPCSTR ServiceClass,
[in, optional] LPCSTR UserObjectDN
);
Parameter
[in] Operation
Menentukan operasi apa yang harus dilakukan DsServerRegisterSpn . Parameter ini dapat memiliki salah satu nilai berikut.
DS_SPN_ADD_SPN_OP
Menambahkan SPN ke akun pengguna atau komputer.
DS_SPN_DELETE_SPN_OP
Menghapus SPN yang ditentukan dari akun.
DS_SPN_REPLACE_SPN_OP
Menghapus semua SPN yang saat ini terdaftar pada akun pengguna atau komputer dan menggantinya dengan SPN baru.
[in] ServiceClass
Penunjuk ke string konstanta yang dihentikan null yang menentukan kelas layanan. Parameter ini mungkin string apa pun yang unik untuk layanan tersebut; baik nama protokol (misalnya, ldap) atau bentuk string GUID akan berfungsi.
[in, optional] UserObjectDN
Penunjuk ke string konstanta yang dihentikan null yang menentukan nama khusus objek akun pengguna atau komputer untuk menulis SPN. Jika parameter ini NULL, DsServerRegisterSpn menulis ke objek akun pengguna utama atau ditiru yang terkait dengan utas panggilan. Jika utas berjalan dalam konteks keamanan akun LocalSystem, fungsi menulis ke objek akun komputer lokal.
Mengembalikan nilai
Jika fungsi berhasil mendaftarkan satu atau beberapa SPN, fungsi akan mengembalikan ERROR_SUCCESS. Modifikasi dilakukan secara permisif, sehingga menambahkan nilai yang sudah ada tidak mengembalikan kesalahan.
Keterangan
Dua SPN yang terdiri dari fungsi DsServerRegisterSpn memiliki format berikut:
<ServiceClass>/<host>
Dalam satu SPN, komputer host adalah nama DNS komputer lokal yang sepenuhnya memenuhi syarat. Di SPN lainnya, komponen host adalah nama NetBIOS komputer lokal.
Dalam kebanyakan kasus, pemanggil DsServerRegisterSpn harus memiliki hak istimewa administrator domain agar berhasil memodifikasi atribut servicePrincipalName dari objek akun. Pengecualian untuk aturan ini adalah jika utas panggilan berjalan di bawah akun LocalSystem, DsServerRegisterSpn diizinkan jika parameter UserObjectDN adalah NULL atau menentukan nama khusus akun komputer lokal.
Catatan
Header ntdsapi.h mendefinisikan DsServerRegisterSpn sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscessor 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
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | ntdsapi.h |
| Pustaka | Ntdsapi.lib |
| DLL | Ntdsapi.dll |