Função CredDeleteA (wincred.h)

A função CredDelete exclui uma credencial do conjunto de credenciais do usuário. O conjunto de credenciais usado é o associado à sessão de logon do token atual. O token não deve ter o SID do usuário desabilitado.

Sintaxe

BOOL CredDeleteA(
  [in] LPCSTR TargetName,
  [in] DWORD  Type,
  [in] DWORD  Flags
);

Parâmetros

[in] TargetName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da credencial a ser excluída.

[in] Type

Tipo da credencial a ser excluída. Deve ser um dos tipos definidos CRED_TYPE_*. Para obter uma lista dos tipos definidos, consulte o membro Tipo da estrutura CREDENTIAL .

Se o valor desse parâmetro for CRED_TYPE_DOMAIN_EXTENDED, essa função poderá excluir uma credencial que especifica um nome de usuário quando houver várias credenciais para o mesmo destino. O valor do parâmetro TargetName deve especificar o nome de usuário como|Nome de Usuário de Destino.

[in] Flags

Reservado e deve ser zero.

Retornar valor

A função retorna TRUE em caso de êxito e FALSE em caso de falha. A função GetLastError pode ser chamada para obter um código status mais específico. Os seguintes códigos de status podem ser retornados:

• ERROR_NOT_FOUND

  Não há nenhuma credencial com o TargetName especificado.

• ERROR_NO_SUCH_LOGON_SESSION

  A sessão de logon não existe ou não há nenhum conjunto de credenciais associado a esta sessão de logon. As sessões de logon de rede não têm um conjunto de credenciais associado.

• ERROR_INVALID_FLAGS

  Um sinalizador que não é válido foi especificado para o parâmetro Flags .

Comentários

Requisitos