LSA_AP_CALL_PACKAGE fonction de rappel (ntsecpkg.h)

Article
08/25/2023

Appelée par l’autorité de sécurité locale (LSA) lorsqu’une application de connexion avec une connexion approuvée à LSA appelle la fonction LsaCallAuthenticationPackage et spécifie l’identificateur du package d’authentification.

LsaApCallPackage est appelé pour les applications d’ouverture de session uniquement ; Les appels d’applications qui ne disposent pas du privilège SeTcbPrivilege sont routés vers la fonction LsaApCallPackageUntrusted du package d’authentification spécifié à la place.

Syntaxe

LSA_AP_CALL_PACKAGE LsaApCallPackage;

NTSTATUS LsaApCallPackage(
  [in]  PLSA_CLIENT_REQUEST ClientRequest,
  [in]  PVOID ProtocolSubmitBuffer,
  [in]  PVOID ClientBufferBase,
  [in]  ULONG SubmitBufferLength,
  [out] PVOID *ProtocolReturnBuffer,
  [out] PULONG ReturnBufferLength,
  [out] PNTSTATUS ProtocolStatus
)
{...}

Paramètres

[in] ClientRequest

Pointeur vers une mémoire tampon opaque LSA_CLIENT_REQUEST représentant la requête du client LSA.

[in] ProtocolSubmitBuffer

Fournit un message de protocole spécifique au package d’authentification.

[in] ClientBufferBase

Fournit l’adresse dans le processus client du message de protocole. Cela peut être nécessaire pour remapper les pointeurs dans la mémoire tampon ProtocolSubmitBuffer .

[in] SubmitBufferLength

Spécifie la longueur de la mémoire tampon ProtocolSubmitBuffer , en octets.

[out] ProtocolReturnBuffer

Retourne l’adresse de la mémoire tampon de sortie dans le processus client. Le package d’authentification est chargé d’appeler la fonction AllocateClientBuffer pour allouer la mémoire tampon dans le processus client. Le contenu de cette mémoire tampon est spécifique au package d’authentification.

[out] ReturnBufferLength

Pointeur vers un ULONG qui retourne la longueur de la mémoire tampon ProtocolReturnBuffer , en octets.

[out] ProtocolStatus

Pointeur vers une valeur NTSTATUS. Si la fonction retourne STATUS_SUCCESS, ProtocolStatus renvoie une status d’achèvement définie par le package d’authentification. Les valeurs ProtocolStatus sont spécifiques au package d’authentification.

Vous trouverez plus d’informations sur les codes NTSTATUS dans le fichier Subauth.h fourni avec le Kit de développement logiciel (SDK) platform.

Valeur retournée

Si la fonction réussit, retournez STATUS_SUCCESS. Cette valeur de retour indique que le package d’authentification a tenté de fournir le service demandé. Utilisez le paramètre ProtocolStatus pour renvoyer la status d’achèvement de la demande de service.

Si le package d’authentification n’a pas pu traiter la demande et n’a donc pas tenté de fournir le service demandé, retournez un code NTSTATUS indiquant le problème. Ce code peut être la valeur suivante ou l’une des valeurs de retour de la fonction de stratégie LSA.

Code de retour	Description
STATUS_NO_MEMORY	Le quota de mémoire du client est insuffisant pour allouer la mémoire tampon de sortie.

Notes

Cette fonction doit être implémentée par les packages d’authentification.

Spécifications


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

AllocateClientBuffer

LsaApCallPackageUntrusted

LsaCallAuthenticationPackage

Partager via