LSA_ALLOCATE_CLIENT_BUFFER funzione di callback (ntsecpkg.h)

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.

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

Vedi anche

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE