SecMakeSPN, fonction (ntifs.h)

Article
08/07/2023

SecMakeSPN crée une chaîne de nom de fournisseur de services qui peut être utilisée lors de la communication avec des fournisseurs de services de sécurité spécifiques.

Syntaxe

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

Paramètres

[in] ServiceClass

Pointeur vers une chaîne Unicode spécifiant la classe de service pour le fournisseur de services de sécurité.

[in] ServiceName

Pointeur vers une chaîne Unicode spécifiant le nom du service pour le fournisseur de services de sécurité.

[in, optional] InstanceName

Pointeur vers une chaîne Unicode facultative spécifiant le nom instance pour la connexion avec le fournisseur de services de sécurité.

[in, optional] InstancePort

Numéro de port d’une instance du service. Utilisez 0 pour le port par défaut. Si ce paramètre est égal à zéro, le SPN n’inclut pas de numéro de port.

[in, optional] Referrer

Pointeur vers une chaîne null constante qui spécifie le nom DNS de l’hôte qui a donné une référence d’adresse IP. Ce paramètre est ignoré, sauf si le paramètre ServiceName spécifie une adresse IP.

[in, out] Spn

Pointeur vers une chaîne Unicode pour stocker la chaîne de nom du fournisseur de services de sécurité créée par cette fonction.

[out, optional] Length

Pointeur vers un ULONG qui reçoit la longueur réelle du SPN créé, y compris le caractère null de fin.

[in] Allocate

Variable booléenne indiquant si la mémoire pour le stockage de la chaîne Unicode Spn doit être allouée par cette fonction. Si ce paramètre a la valeur true, la mémoire pour Spn est allouée à partir d’un pool paginé.

Valeur retournée

SecMakeSPN retourne STATUS_SUCCESS en cas de réussite ou l’un des codes d’erreur suivants en cas d’échec.

Code de retour	Description
STATUS_BUFFER_OVERFLOW	Le paramètre Allocate a été défini sur false et l’une des conditions suivantes s’est produite : (1) Le paramètre Spn était un pointeur NULL. (2) La longueur maximale du paramètre de chaîne Spn Unicode était trop petite.
STATUS_INVALID_PARAMETER	La longueur totale du paramètre Spn dépasse 65535 octets.
STATUS_NO_MEMORY	Le paramètre Allocate a été défini sur true, mais la demande d’allocation de mémoire a échoué.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h, FltKernel.h)
Bibliothèque	Ksecdd.lib
IRQL	<= APC_LEVEL

Voir aussi

SecMakeSPNEx

SecMakeSPNEx2

Partager via