Funzione SecMakeSPNEx2 (ntifs.h)

Articolo
12/21/2024

SecMakeSPNEx2 crea una stringa del nome del provider di servizi che può essere usata quando comunica con provider di servizi di sicurezza specifici.

Sintassi

KSECDDDECLSPEC NTSTATUS SecMakeSPNEx2(
  [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, optional]  IN PUNICODE_STRING     InTargetInfo,
  [in, out]       IN OUT PUNICODE_STRING Spn,
  [out, optional] OUT PULONG             TotalSize,
  [in]            IN BOOLEAN             Allocate,
  [in]            IN BOOLEAN             IsTargetInfoMarshaled
);

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 utilizzato per connettersi 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 fornito una segnalazione di indirizzo IP. Questo parametro viene ignorato a meno che il parametro NomeServizio non specifichi un indirizzo IP.

[in, optional] InTargetInfo

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

[in, out] Spn

Puntatore a una stringa Unicode che riceve la stringa del nome del provider del servizio di sicurezza creata da questa funzione.

[out, optional] TotalSize

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

[in] IsTargetInfoMarshaled

Variabile booleana che indica che il chiamante ha fornito un struttura di InTargetInfo con marshalling. Se isTargetInfoMarshaled è TRUE, InTargetInfo->Buffer punta a una rappresentazione di stringa della struttura CREDENTIAL_TARGET_INFORMATION restituita dalla funzione CredMarshalTargetInfo.

Valore restituito

secMakeSPNEx2 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

secMakeSPNEx2 è una versione avanzata di SecMakeSPNEx.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h, FltKernel.h)
libreria	Ksecdd.lib
IRQL	<= APC_LEVEL

Vedere anche

SecMakeSPN

secMakeSPNEx

Condividi tramite