Share via

Fonction de rappel SpInitUserModeContextFn (ntsecpkg.h)

  • Article

La fonction SpInitUserModeContext crée un contexte de sécurité en mode utilisateur à partir d’un contexte en mode LSA (Local Security Authority ) packed.

Syntaxe

SpInitUserModeContextFn Spinitusermodecontextfn;

NTSTATUS Spinitusermodecontextfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] PSecBuffer PackedContext
)
{...}

Paramètres

[in] ContextHandle

Handle vers le contexte en mode LSA retourné par la fonction SpInitLsaModeContext ou SpAcceptLsaModeContext .

[in] PackedContext

Pointeur vers une structure SecBuffer qui contient les données de contexte sérialisées . Utilisez la fonction FreeContextBuffer pour libérer la mémoire allouée pour cette structure.

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. La liste suivante répertorie une raison courante de l’échec et le code d’erreur que la fonction doit retourner.

Code de retour Description
STATUS_INSUFFICIENT_RESOURCES
 Mémoire insuffisante pour créer le contexte.

Remarques

La fonction SpInitUserModeContext est appelée une fois qu’un contexte de sécurité a été créé par le package de sécurité, si le paramètre MapContext du SpInitLsaModeContext ou spAcceptLsaModeContext a la valeur TRUE. Les données de contexte spécifiques au package doivent contenir les informations nécessaires pour déterminer quelle fonction a entraîné l’appel à SpInitUserModeContext.

SSP/APs doivent implémenter la fonction SpInitUserModeContext ; toutefois, le nom réel donné à l’implémentation appartient au développeur.

Un pointeur vers la fonction SpInitUserModeContext est disponible dans la structure SECPKG_USER_FUNCTION_TABLE reçue de la fonction SpUserModeInitialize .

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

SpAcceptLsaModeContext

SpInitLsaModeContext

SpUserModeInitialize