LSA_ALLOCATE_CLIENT_BUFFER funzione di callback (ntsecpkg.h)

Articolo
02/29/2024

Alloca un buffer nello spazio indirizzi del client. I buffer allocati nello spazio indirizzi del client vengono usati per contenere informazioni restituite al client da un pacchetto di autenticazione.

Sintassi

LSA_ALLOCATE_CLIENT_BUFFER LsaAllocateClientBuffer;

NTSTATUS LsaAllocateClientBuffer(
  [in]  PLSA_CLIENT_REQUEST ClientRequest,
  [in]  ULONG LengthRequired,
  [out] PVOID *ClientBaseAddress
)
{...}

Parametri

[in] ClientRequest

Puntatore a una struttura di dati LSA_CLIENT_REQUEST opaca che contiene informazioni sulla richiesta di autenticazione del client LSA. Un pacchetto di autenticazione personalizzato deve passare il valore ricevuto durante la chiamata del client alla funzione, ad esempio LsaApCallPackage o LsaApLogonUser, che restituisce il parametro di output.

[in] LengthRequired

Lunghezza del buffer necessaria, in byte.

[out] ClientBaseAddress

Puntatore che riceve l'indirizzo del buffer. Questo indirizzo è l'indirizzo virtuale del buffer all'interno del processo client, non nel processo corrente.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è STATUS_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS, che può essere il valore seguente o uno dei valori restituiti della funzione Criteri LSA.

Codice restituito	Descrizione
STATUS_NO_MEMORY	Il processo client non ha una quota di memoria adeguata per allocare il buffer.

La funzione LsaNtStatusToWinError converte un codice NTSTATUS in un codice di errore di Windows.

Commenti

Il pacchetto di autenticazione o il processo client devono quindi liberare il buffer. Il processo di autenticazione può liberare il buffer usando la routine di invio FreeClientBuffer . Il processo client può liberare il buffer usando la funzione LsaFreeReturnBuffer .

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

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE

Condividi tramite