Funzione DsClientMakeSpnForTargetServerA (ntdsapi.h)

Articolo
11/20/2024

La funzione DsClientMakeSpnForTargetServer costruisce un nome dell'entità servizio (SPN) che identifica un server specifico da usare per l'autenticazione.

Sintassi

NTDSAPI DWORD DsClientMakeSpnForTargetServerA(
  [in]      LPCSTR ServiceClass,
  [in]      LPCSTR ServiceName,
  [in, out] DWORD  *pcSpnLength,
  [out]     LPSTR  pszSpn
);

Parametri

[in] ServiceClass

Puntatore a una stringa con terminazione Null che contiene la classe del servizio come definito dal servizio. Può trattarsi di qualsiasi stringa univoca per il servizio.

[in] ServiceName

Puntatore a una stringa con terminazione Null che contiene il nome host dns (Distinguished Name Service). Può trattarsi di un nome completo o di un indirizzo IP nel formato standard Internet.

Non è consigliabile usare un indirizzo IP per ServiceName perché ciò può creare un problema di sicurezza. Prima della costruzione del nome SPN, l'indirizzo IP deve essere convertito in un nome computer tramite la risoluzione dei nomi DNS. È possibile che la risoluzione dei nomi DNS venga eseguita tramite spoofing, sostituendo il nome computer previsto con un nome computer non autorizzato.

[in, out] pcSpnLength

Puntatore a un valore DWORD che, nella voce, contiene le dimensioni del buffer pszSpn , in caratteri. In caso di output, questo parametro riceve il numero di caratteri copiati nel buffer pszSpn , incluso il NULLdi terminazione.

[out] pszSpn

Puntatore a un buffer stringa che riceve il nome SPN.

Valore restituito

Questa funzione restituisce i codici di errore standard di Windows.

Osservazioni

Quando si usa questa funzione, specificare la classe del servizio e parte di un nome host DNS.

Questa funzione è una versione semplificata della funzione DsMakeSpn. Il ServiceName viene reso canonico risolvendo tramite DNS.

I nomi DNS basati su GUID non sono supportati. In caso di costruzione, il nome SPN semplificato è il seguente:

ServiceClass / ServiceName / ServiceName

La parte del nome dell'istanza (seconda posizione) è sempre impostata su default. I campi porta e referrer non vengono usati.

Nota

L'intestazione ntdsapi.h definisce DsClientMakeSpnForTargetServer come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Finestre
intestazione	ntdsapi.h
libreria	Ntdsapi.lib
dll	Ntdsapi.dll

Vedere anche

controller di dominio e funzioni di gestione della replica

DsMakeSpn

Condividi tramite