Fungsi SecMakeSPNEx (ntifs.h)

  • Artikel

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