DsClientMakeSpnForTargetServerW, fonction (ntdsapi.h)

Article
11/20/2024

La fonction DsClientMakeSpnForTargetServer construit un nom de principal de service (SPN) qui identifie un serveur spécifique à utiliser pour l’authentification.

Syntaxe

NTDSAPI DWORD DsClientMakeSpnForTargetServerW(
  [in]      LPCWSTR ServiceClass,
  [in]      LPCWSTR ServiceName,
  [in, out] DWORD   *pcSpnLength,
  [out]     LPWSTR  pszSpn
);

Paramètres

[in] ServiceClass

Pointeur vers une chaîne terminée par null qui contient la classe du service telle que définie par le service. Il peut s’agir de n’importe quelle chaîne unique au service.

[in] ServiceName

Pointeur vers une chaîne terminée par null qui contient le nom d’hôte du service de nom unique (DNS). Il peut s’agir d’un nom complet ou d’une adresse IP au format standard Internet.

L’utilisation d’une adresse IP pour ServiceName n’est pas recommandée, car cela peut créer un problème de sécurité. Avant la construction du SPN, l’adresse IP doit être traduite en nom d’ordinateur par le biais de la résolution de noms DNS. Il est possible que la résolution de noms DNS soit usurpée, en remplaçant le nom d’ordinateur prévu par un nom d’ordinateur non autorisé.

[in, out] pcSpnLength

Pointeur vers une valeur DWORD qui, lors de l’entrée, contient la taille de la mémoire tampon pszSpn , en caractères. En sortie, ce paramètre reçoit le nombre de caractères copiés dans la mémoire tampon pszSpn , y compris la fin NULL.

[out] pszSpn

Pointeur vers une mémoire tampon de chaîne qui reçoit le SPN.

Valeur de retour

Cette fonction retourne des codes d’erreur Windows standard.

Remarques

Lorsque vous utilisez cette fonction, fournissez la classe de service et une partie d’un nom d’hôte DNS.

Cette fonction est une version simplifiée de la fonction DsMakeSpn. Le ServiceName est rendu canonique en résolvant via DNS.

Les noms DNS basés sur GUID ne sont pas pris en charge. Lorsqu’il est construit, le SPN simplifié est le suivant :

ServiceClass / ServiceName / ServiceName

La partie nom de l’instance (deuxième position) est toujours définie sur la valeur par défaut. Les champs de port et de référence ne sont pas utilisés.

Note

L’en-tête ntdsapi.h définit DsClientMakeSpnForTargetServer comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Windows
d’en-tête	ntdsapi.h
bibliothèque	Ntdsapi.lib
DLL	Ntdsapi.dll

Voir aussi

fonctions de gestion du contrôleur de domaine et de la réplication

DsMakeSpn

Partager via