Funzione SecMakeSPNEx (ntifs.h)

Articolo
12/21/2024

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

Sintassi

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
);

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] InstanceName

Puntatore a una stringa Unicode facoltativa che specifica il nome dell'istanza per la connessione con il 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 fornito una segnalazione di indirizzo IP. Questo parametro viene ignorato a meno che il parametro NomeServizio non specifichi un indirizzo IP.

[in, optional] TargetInfo

Puntatore a una stringa con terminazione Null che indica la destinazione del contesto.

[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 del Spn stringa Unicode deve essere allocata da questa funzione. Se questo parametro è true, la memoria per Spn verrà allocata dal pool di paging.

Valore restituito

secMakeSPNEx 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 spn stringa Unicode è 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.

Osservazioni

SecMakeSPNEx è una versione avanzata di SecMakeSPN.

Fabbisogno

Requisito	Valore
client minimo supportato	Questa funzione è solo Windows XP
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h, FltKernel.h)
libreria	Ksecdd.lib
IRQL	<= APC_LEVEL

Vedere anche

SecMakeSPN

secMakeSPNEx2

Condividi tramite