Fonction de rappel SpUserModeInitializeFn (ntsecpkg.h)

Article
02/29/2024

La fonction SpUserModeInitialize est appelée lorsqu’une DLL depackage d’authentification du fournisseur/ de prise en charge de la sécurité (SSP/AP) est chargée dans l’espace de processus d’une application cliente/serveur. Cette fonction fournit les tables SECPKG_USER_FUNCTION_TABLE pour chaque package de sécurité dans la DLL SSP/AP.

Syntaxe

SpUserModeInitializeFn Spusermodeinitializefn;

NTSTATUS Spusermodeinitializefn(
  [in]  ULONG LsaVersion,
  [out] PULONG PackageVersion,
  [out] PSECPKG_USER_FUNCTION_TABLE *ppTables,
  [out] PULONG pcTables
)
{...}

Paramètres

[in] LsaVersion

Version de la DLL du fournisseur de sécurité (Secur32.dll ou Security.dll).

[out] PackageVersion

Pointeur qui retourne la version de la DLL SSP/AP.

[out] ppTables

Pointeur qui retourne un tableau de structures SECPKG_USER_FUNCTION_TABLE . Chaque structure est une table de pointeurs vers les fonctions en mode utilisateur implémentées par un package de sécurité déployé dans la DLL SSP/AP.

[out] pcTables

Pointeur qui retourne le nombre d’éléments dans le tableau pointé vers le paramètre ppTables .

Valeur retournée

Si la fonction réussit, retournez STATUS_SUCCESS.

Si la fonction échoue, retourne un code NTSTATUS qui indique la raison de son échec.

Remarques

La fonction SpUserModeInitialize doit être implémentée par des DLL SSP/AP qui contiennent des packages de sécurité en mode utilisateur.

Le paramètre ppTables doit contenir un SECPKG_USER_FUNCTION_TABLE pour chaque package de sécurité en mode utilisateur déployé dans la DLL. Pour plus d’informations sur le déploiement de packages de sécurité dans des DLL, consultez Initialisation en mode utilisateur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ntsecpkg.h

Voir aussi

SECPKG_USER_FUNCTION_TABLE

Partager via