Compartilhar via


LSA_ALLOCATE_CLIENT_BUFFER função de retorno de chamada (ntsecpkg.h)

Aloca um buffer no espaço de endereço do cliente. Os buffers alocados no espaço de endereço do cliente são usados para armazenar informações retornadas ao cliente de um pacote de autenticação.

Sintaxe

LSA_ALLOCATE_CLIENT_BUFFER LsaAllocateClientBuffer;

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

Parâmetros

[in] ClientRequest

Ponteiro para uma estrutura de dados de LSA_CLIENT_REQUEST opaca que contém informações sobre a solicitação de autenticação do cliente LSA. Um pacote de autenticação personalizado deve passar o valor recebido durante a chamada do cliente para a função, como LsaApCallPackage ou LsaApLogonUser, que retorna o parâmetro de saída.

[in] LengthRequired

Comprimento do buffer necessário, em bytes.

[out] ClientBaseAddress

Ponteiro que recebe o endereço do buffer. Esse endereço é o endereço virtual do buffer dentro do processo do cliente, não no processo atual.

Retornar valor

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um código NTSTATUS, que pode ser o valor a seguir ou um dos valores retornados da função de política LSA.

Código de retorno Descrição
STATUS_NO_MEMORY
O processo do cliente não tem uma cota de memória adequada para alocar o buffer.
 

A função LsaNtStatusToWinError converte um código NTSTATUS em um código de erro do Windows.

Comentários

O pacote de autenticação ou o processo do cliente devem liberar posteriormente o buffer. O processo de autenticação pode liberar o buffer usando a rotina de expedição FreeClientBuffer . O processo do cliente pode liberar o buffer usando a função LsaFreeReturnBuffer .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecpkg.h

Confira também

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE