LSA_AP_CALL_PACKAGE funzione di callback (ntsecpkg.h)

Articolo
08/25/2023

Chiamato dall'Autorità di sicurezza locale (LSA) quando un'applicazione di accesso con una connessione attendibile all'LSA chiama la funzione LsaCallAuthenticationPackage e specifica l'identificatore del pacchetto di autenticazione.

LsaApCallPackage viene chiamato solo per le applicazioni di accesso; le chiamate dalle applicazioni che non dispongono del privilegio SeTcbPrivilege vengono instradate alla funzione LsaApCallPackageUntrusted del pacchetto di autenticazione specificato.

Sintassi

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
)
{...}

Parametri

[in] ClientRequest

Puntatore a un buffer LSA_CLIENT_REQUEST opaco che rappresenta la richiesta del client LSA.

[in] ProtocolSubmitBuffer

Fornisce un messaggio di protocollo specifico per il pacchetto di autenticazione.

[in] ClientBufferBase

Fornisce l'indirizzo all'interno del processo client del messaggio del protocollo. Potrebbe essere necessario eseguire il mapping di tutti i puntatori all'interno del buffer ProtocolSubmitBuffer .

[in] SubmitBufferLength

Specifica la lunghezza del buffer ProtocolSubmitBuffer , in byte.

[out] ProtocolReturnBuffer

Restituisce l'indirizzo del buffer di output all'interno del processo client. Il pacchetto di autenticazione è responsabile della chiamata della funzione AllocateClientBuffer per allocare il buffer all'interno del processo client. Il contenuto di questo buffer è specifico del pacchetto di autenticazione.

[out] ReturnBufferLength

Puntatore a un oggetto ULONG che restituisce la lunghezza del buffer ProtocolReturnBuffer , in byte.

[out] ProtocolStatus

Puntatore a un valore NTSTATUS. Se la funzione restituisce STATUS_SUCCESS, ProtocolStatus restituisce uno stato di completamento impostato dal pacchetto di autenticazione. I valori ProtocolStatus sono specifici del pacchetto di autenticazione.

Altre informazioni sui codici NTSTATUS sono disponibili nel file Subauth.h fornito con Platform SDK.

Valore restituito

Se la funzione ha esito positivo, restituire STATUS_SUCCESS. Questo valore restituito indica che il pacchetto di autenticazione ha tentato di fornire il servizio richiesto. Usare il parametro ProtocolStatus per restituire lo stato di completamento della richiesta di servizio.

Se il pacchetto di autenticazione non è riuscito a elaborare la richiesta e pertanto non ha tentato di fornire il servizio richiesto, restituire un codice NTSTATUS che indica il problema. Questo codice può essere il valore seguente o uno dei valori restituiti della funzione Criteri LSA.

Codice restituito	Descrizione
STATUS_NO_MEMORY	La quota di memoria del client non è sufficiente per allocare il buffer di output.

Commenti

Questa funzione deve essere implementata dai pacchetti di autenticazione.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntsecpkg.h

Vedi anche

AllocateClientBuffer

LsaApCallPackageUntrusted

LsaCallAuthenticationPackage