LSA_AP_CALL_PACKAGE_PASSTHROUGH funzione di callback (ntsecpkg.h)

Articolo
08/25/2023

Funzione di invio per le richieste di accesso pass-through inviate alla funzione LsaCallAuthenticationPackage .

Sintassi

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

Parametri

[in] ClientRequest

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

[in] ProtocolSubmitBuffer

Fornisce un messaggio specifico del protocollo al pacchetto di autenticazione.

[in] ClientBufferBase

Fornisce l'indirizzo all'interno del processo client del messaggio del protocollo. Potrebbe essere necessario eseguire il mapping dei puntatori all'interno del ProtocolloSubmitBuffer.

[in] SubmitBufferLength

Specifica la lunghezza del buffer ProtocolSubmitBuffer , in byte.

[out] ProtocolReturnBuffer

Restituisce l'indirizzo del buffer di output nel processo client. Il pacchetto di autenticazione è responsabile della chiamata della funzione AllocateClientBuffer per allocare il buffer nel 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

Requisito	Valore
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

LsaCallAuthenticationPackage