Funzione SecMakeSPN (ntifs.h)

Articolo
08/07/2023

SecMakeSPN crea una stringa di nome del provider di servizi che può essere usata durante la comunicazione con provider di servizi di sicurezza specifici.

Sintassi

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

Parametri

[in] ServiceClass

Puntatore a una stringa Unicode che specifica la classe del servizio per il provider di servizi di sicurezza.

[in] ServiceName

Puntatore a una stringa Unicode che specifica il nome del servizio per il provider di servizi di sicurezza.

[in, optional] InstanceName

Puntatore a una stringa Unicode facoltativa che specifica il nome dell'istanza per la connessione al provider di servizi di sicurezza.

[in, optional] InstancePort

Numero di porta per un'istanza del servizio. Usare 0 per la porta predefinita. Se questo parametro è zero, il nome SPN non include un numero di porta.

[in, optional] Referrer

Puntatore a una stringa costante con terminazione Null che specifica il nome DNS dell'host che ha assegnato una segnalazione di indirizzo IP. Questo parametro viene ignorato a meno che il parametro ServiceName non specifichi un indirizzo IP.

[in, out] Spn

Puntatore a una stringa Unicode per l'archiviazione della stringa del nome del provider del servizio di sicurezza creata da questa funzione.

[out, optional] Length

Puntatore a un ULONG che riceve la lunghezza effettiva del nome SPN creato, incluso il carattere Null di terminazione.

[in] Allocate

Variabile booleana che indica se la memoria per l'archiviazione della stringa Unicode Spn deve essere allocata da questa funzione. Se questo parametro è true, la memoria per Spn verrà allocata dal pool di paging.

Valore restituito

SecMakeSPN restituisce STATUS_SUCCESS in caso di esito positivo o uno dei codici di errore seguenti in caso di errore.

Codice restituito	Descrizione
STATUS_BUFFER_OVERFLOW	Il parametro Allocate è stato impostato su false e si è verificata una delle condizioni seguenti: (1) Il parametro Spn era un puntatore NULL. (2) La lunghezza massima per il parametro stringa Unicode Spn era troppo piccola.
STATUS_INVALID_PARAMETER	Una lunghezza totale del parametro Spn supera i 65535 byte.
STATUS_NO_MEMORY	Il parametro Allocate è stato impostato su true, ma la richiesta di allocazione della memoria non è riuscita.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Ntifs.h, FltKernel.h)
Libreria	Ksecdd.lib
IRQL	<= APC_LEVEL

Vedi anche

SecMakeSPNEx

SecMakeSPNEx2

Condividi tramite