Função LsaFreeMemory (ntsecapi.h)

  • Artigo

A função LsaFreeMemory libera memória alocada para um buffer de saída por uma chamada de função LSA. As funções LSA que retornam buffers de saída de comprimento variável sempre alocam o buffer em nome do chamador. O chamador deve liberar essa memória passando o ponteiro de buffer retornado para LsaFreeMemory quando a memória não for mais necessária.

Sintaxe

NTSTATUS LsaFreeMemory(
  [in] PVOID Buffer
);

Parâmetros

[in] Buffer

Ponteiro para o buffer de memória que foi alocado por uma chamada de função LSA. Se LsaFreeMemory for bem-sucedido, esse buffer será liberado.

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_UNSUCCESSFUL
 Não foi possível liberar a memória porque ela não foi alocada por uma chamada de função LSA.
 

Você pode usar a função LsaNtStatusToWinError para converter o código NTSTATUS em um código de erro do Windows.

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 ntsecapi.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

Valores retornados da função de política LSA

LsaNtStatusToWinError