Funzione DsClientMakeSpnForTargetServerA (ntdsapi.h)

Articolo
02/29/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 contenente il nome host dns (Distinguished Name Service). Può trattarsi di un nome completo o di un indirizzo IP nel formato standard Internet.

L'uso di un indirizzo IP per ServiceName non è consigliato perché 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 falsificata, sostituendo il nome del 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. Nell'output, questo parametro riceve il numero di caratteri copiati nel buffer pszSpn , incluso il valore NULL di 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.

Commenti

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 . 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	ntdsapi.h
Libreria	Ntdsapi.lib
DLL	Ntdsapi.dll

Vedi anche

Funzioni di gestione del controller di dominio e della replica

DsMakeSpn

Condividi tramite