Fungsi SecMakeSPNEx (ntifs.h)

Artikel
02/26/2024

SecMakeSPNEx membuat string nama penyedia layanan yang dapat digunakan saat berkomunikasi dengan penyedia layanan keamanan tertentu.

Sintaks

KSECDDDECLSPEC NTSTATUS SecMakeSPNEx(
  [in]            IN PUNICODE_STRING     ServiceClass,
  [in]            IN PUNICODE_STRING     ServiceName,
  [in]            IN PUNICODE_STRING     InstanceName,
  [in, optional]  IN USHORT              InstancePort,
  [in, optional]  IN PUNICODE_STRING     Referrer,
  [in, optional]  IN PUNICODE_STRING     TargetInfo,
  [in, out]       IN OUT PUNICODE_STRING Spn,
  [out, optional] OUT PULONG             Length,
  [in]            IN BOOLEAN             Allocate
);

Parameter

[in] ServiceClass

Penunjuk ke string Unicode yang menentukan kelas layanan untuk penyedia layanan keamanan.

[in] ServiceName

Penunjuk ke string Unicode yang menentukan nama layanan untuk penyedia layanan keamanan.

[in] InstanceName

Penunjuk ke string Unicode opsional yang menentukan nama instans untuk menyambungkan dengan penyedia layanan keamanan.

[in, optional] InstancePort

Nomor port untuk instans layanan. Gunakan 0 untuk port default. Jika parameter ini nol, SPN tidak menyertakan nomor port.

[in, optional] Referrer

Penunjuk ke string konstanta yang dihentikan null yang menentukan nama DNS host yang memberikan rujukan alamat IP. Parameter ini diabaikan kecuali parameter ServiceName menentukan alamat IP.

[in, optional] TargetInfo

Penunjuk ke string yang dihentikan null yang menunjukkan target konteks.

[in, out] Spn

Penunjuk ke string Unicode untuk menyimpan string nama penyedia layanan keamanan yang dibuat oleh fungsi ini.

[out, optional] Length

Penunjuk ke ULONG yang menerima panjang sebenarnya dari SPN yang dibuat, termasuk karakter null yang mengakhiri.

[in] Allocate

Variabel Boolean yang menunjukkan apakah memori untuk menyimpan string Spn Unicode harus dialokasikan oleh fungsi ini. Jika parameter ini benar, memori untuk Spn akan dialokasikan dari kumpulan halaman.

Nilai kembali

SecMakeSPNEx mengembalikan STATUS_SUCCESS pada keberhasilan atau salah satu kode kesalahan berikut pada kegagalan.

Menampilkan kode	Deskripsi
STATUS_BUFFER_OVERFLOW	Parameter Alokasi diatur ke false dan salah satu kondisi berikut terjadi: (1) Parameter Spn adalah penunjuk NULL. (2) Panjang maksimum untuk parameter string Spn Unicode terlalu kecil.
STATUS_INVALID_PARAMETER	Panjang total parameter Spn melebihi 65535 byte.
STATUS_NO_MEMORY	Parameter Alokasikan diatur ke true, tetapi permintaan alokasi memori gagal.

Keterangan

SecMakeSPNEx adalah versi SecMakeSPN yang disempurnakan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Fungsi ini hanya Windows XP
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h, FltKernel.h)
Pustaka	Ksecdd.lib
IRQL	<= APC_LEVEL

Lihat juga

SecMakeSPN

SecMakeSPNEx2

Bagikan melalui