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

Voir aussi

SECPKG_FUNCTION_TABLE

SECPKG_PARAMETERS

SpLsaModeInitialize