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

  • Artigo

Exclui uma credencial existente.

Essa função exclui a primeira credencial encontrada com uma ID de sessão de logon correspondente, a ID do pacote de autenticação e o valor da chave de pesquisa primária. Se houver várias credenciais correspondentes, apenas uma delas será excluída.

Essa função não é usada por pacotes de autenticação mais recentes, como Kerberos.

Sintaxe

LSA_DELETE_CREDENTIAL LsaDeleteCredential;

NTSTATUS LsaDeleteCredential(
  [in] PLUID LogonId,
  [in] ULONG AuthenticationPackage,
  [in] PLSA_STRING PrimaryKeyValue
)
{...}

Parâmetros

[in] LogonId

Ponteiro para uma estrutura LUID que contém a ID de sessão da sessão de logon da qual a credencial deve ser excluída.

[in] AuthenticationPackage

ID do pacote de autenticação do pacote de autenticação de chamada recebido na chamada LsaApInitializePackage durante a inicialização da DLL.

[in] PrimaryKeyValue

Contém a chave de pesquisa primária da credencial a ser excluída.

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 um dos valores a seguir ou um dos valores retornados da função de política LSA.

Código de retorno Descrição
ERROR_GEN_FAILURE
 Não foi possível encontrar nenhuma credencial correspondente.
STATUS_NO_SUCH_LOGON_SESSION
 Não foi possível encontrar a sessão de logon especificada.
 

A função LsaNtStatusToWinError converte um 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 ntsecpkg.h

Confira também

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE