Fungsi DsCrackSpnA (dsparse.h)

Fungsi DsCrackSpn mengurai nama perwakilan layanan (SPN) ke dalam string komponennya.

Sintaksis

DSPARSE DWORD DsCrackSpnA(
  [in]                LPCSTR  pszSpn,
  [in, out, optional] LPDWORD pcServiceClass,
  [out, optional]     LPSTR   ServiceClass,
  [in, out, optional] LPDWORD pcServiceName,
  [out, optional]     LPSTR   ServiceName,
  [in, out, optional] LPDWORD pcInstanceName,
  [out, optional]     LPSTR   InstanceName,
  [out, optional]     USHORT  *pInstancePort
);

Parameter

[in] pszSpn

Penunjuk ke string yang dihentikan null konstanta yang berisi SPN untuk diurai. SPN memiliki format berikut, di mana> kelas layanan <dan komponen> nama instans <harus ada dan nomor port <> dan komponen> nama layanan <bersifat opsional. Komponen> nomor port <harus berupa nilai string numerik.

<service class>/<instance name>:<port number>/<service name>

[in, out, optional] pcServiceClass

Penunjuk ke nilai DWORD yang, pada entri, berisi ukuran, dalam TCHAR, dari serviceClass buffer, termasuk karakter null yang mengakhiri. Saat keluar, parameter ini berisi jumlah TCHAR dalam string ServiceClass , termasuk karakter null yang mengakhiri.

Jika parameter ini null, berisi nol, atau ServiceClass NULL, parameter ini dan ServiceClass diabaikan.

Untuk mendapatkan jumlah karakter yang diperlukan untuk string ServiceClass , termasuk terminator null, panggil fungsi ini dengan SPN yang valid, serviceClassNULL non-dan parameter ini diatur ke 1.

[out, optional] ServiceClass

Pointer ke buffer TCHAR yang menerima string null-terminated yang berisi kelas layanan komponen SPN. Buffer ini setidaknya harus berukuran *pcServiceClass TCHAR. Parameter ini mungkin null jika kelas layanan tidak diperlukan.

[in, out, optional] pcServiceName

Pointer ke nilai DWORD yang, pada entri, berisi ukuran, dalam TCHAR, dari serviceName buffer, termasuk karakter null yang mengakhiri. Saat keluar, parameter ini berisi jumlah TCHAR dalam string ServiceName , termasuk karakter null yang mengakhiri.

Jika parameter ini null, berisi nol, atau ServiceName NULL, parameter ini dan ServiceName diabaikan.

Untuk mendapatkan jumlah karakter yang diperlukan untuk string ServiceName , termasuk terminator null, panggil fungsi ini dengan SPN yang valid,NULLServiceName dan parameter ini diatur ke 1.

[out, optional] ServiceName

Pointer ke buffer TCHAR yang menerima string null-terminated yang berisi nama layanan komponen SPN. Buffer ini setidaknya harus berukuran *pcServiceName TCHAR. Jika komponen> nama layanan <tidak ada di SPN, buffer ini menerima nama instans <> komponen. Parameter ini mungkin NULL jika nama layanan tidak diperlukan.

[in, out, optional] pcInstanceName

Pointer ke nilai DWORD yang, pada entri, berisi ukuran, dalam TCHAR, dari instanceName buffer, termasuk karakter null yang mengakhiri. Saat keluar, parameter ini berisi jumlah TCHAR dalam string InstanceName, termasuk karakter null yang mengakhiri.

Jika parameter ini null, berisi nol, atau InstanceNameNULL, parameter ini dan InstanceName diabaikan.

Untuk mendapatkan jumlah karakter yang diperlukan untuk string InstanceName, termasuk terminator null, panggil fungsi ini dengan SPN yang valid,InstanceName non-NULL dan parameter ini diatur ke 1.

[out, optional] InstanceName

Penunjuk ke buffer TCHAR yang menerima string null-terminated yang berisi nama instans komponen SPN. Buffer ini setidaknya harus berukuran *pcInstanceName TCHAR. Parameter ini mungkin NULL jika nama instans tidak diperlukan.

[out, optional] pInstancePort

Penunjuk ke nilai DWORD yang menerima nilai bilangan bulat nomor port komponen SPN. Jika SPN tidak berisi <nomor port> komponen, parameter ini menerima nol. Parameter ini mungkin NULL jika nomor port tidak diperlukan.

Mengembalikan nilai

Mengembalikan kode kesalahan Win32, termasuk yang berikut ini.

Komentar

Nota

Header dsparse.h mendefinisikan DsCrackSpn 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	dsparse.h (termasuk Ntdsapi.h)
Pustaka	Ntdsapi.lib
DLL	Ntdsapi.dll

Lihat juga

Fungsi Pengendali Domain dan Manajemen Replikasi