Fonction de rappel SpInitializeFn (ntsecpkg.h)
La fonction SpInitialize est appelée une seule fois par l’autorité de sécurité locale (LSA) pour fournir un package de sécurité avec des informations de sécurité générales et une table de répartition des fonctions de support. Le package de sécurité doit enregistrer les informations et effectuer un traitement d’initialisation interne, le cas échéant.
Syntaxe
SpInitializeFn Spinitializefn;
NTSTATUS Spinitializefn(
[in] ULONG_PTR PackageId,
[in] PSECPKG_PARAMETERS Parameters,
[in] PLSA_SECPKG_FUNCTION_TABLE FunctionTable
)
{...}
Paramètres
[in] PackageId
Identificateur unique que LSA affecte à chaque package de sécurité. La valeur est valide jusqu’à ce que le système soit redémarré.
[in] Parameters
Pointeur vers une structure de SECPKG_PARAMETERS contenant des informations sur le domaine principal et l’état de l’ordinateur.
[in] FunctionTable
Pointeur vers une table de fonctions de prise en charge LSA qu’un package de sécurité peut appeler.
Valeur retournée
Si la fonction réussit, retournez STATUS_SUCCESS ou un code de status d’informations.
Si la fonction échoue, retournez un code d’erreur NTSTATUS indiquant la raison de son échec. Pour plus d'informations, consultez la section Notes.
Remarques
Si SpInitialize retourne un code d’erreur NTSTATUS à LSA, le package est déchargé et l’autorité de sécurité locale (LSA) ne l’inclut pas dans la liste des packages de sécurité disponibles.
SSP/APs doivent implémenter la fonction SpInitialize ; toutefois, le nom réel donné à l’implémentation appartient au développeur.
Un pointeur vers l’implémentation de la fonction SpInitialize par le fournisseur de services/AP doit se trouver dans la structure SECPKG_FUNCTION_TABLE passée au LSA à partir de la fonction SpLsaModeInitialize .
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 |