LSA_AP_CALL_PACKAGE_PASSTHROUGH fonction de rappel (ntsecpkg.h)

Article
02/29/2024

Fonction dispatch pour les demandes d’ouverture de session directes envoyées à la fonction LsaCallAuthenticationPackage .

Syntaxe

LSA_AP_CALL_PACKAGE_PASSTHROUGH LsaApCallPackagePassthrough;

NTSTATUS LsaApCallPackagePassthrough(
  [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 spécifique au protocole 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 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.

Remarques

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

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

AllocateClientBuffer

LsaCallAuthenticationPackage

Partager via