SecMakeSPNEx, fonction (ntifs.h)

Article
03/01/2024

SecMakeSPNEx 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 SecMakeSPNEx(
  [in]            IN PUNICODE_STRING     ServiceClass,
  [in]            IN PUNICODE_STRING     ServiceName,
  [in]            IN PUNICODE_STRING     InstanceName,
  [in, optional]  IN USHORT              InstancePort,
  [in, optional]  IN PUNICODE_STRING     Referrer,
  [in, optional]  IN PUNICODE_STRING     TargetInfo,
  [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] InstanceName

Pointeur vers une chaîne Unicode facultative spécifiant le nom instance pour la connexion au 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 constante terminée par un caractère Null 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, optional] TargetInfo

Pointeur vers une chaîne terminée par null qui indique la cible du contexte.

[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 du pool paginé.

Valeur retournée

SecMakeSPNEx 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 Unicode Spn é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é.

Remarques

SecMakeSPNEx est une version améliorée de SecMakeSPN.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette fonction est uniquement Windows XP
Plateforme cible	Universal
En-tête	ntifs.h (include Ntifs.h, FltKernel.h)
Bibliothèque	Ksecddd.lib
IRQL	<= APC_LEVEL

Voir aussi

SecMakeSPN

SecMakeSPNEx2

Partager via