Compartilhar via


Função CredRenameA (wincred.h)

[Não há mais suporte para CredRename . A partir do Windows Vista, as chamadas para CredRename sempre retornam ERROR_NOT_SUPPORTED.]

A função CredRename renomeia uma credencial no 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 CredRenameA(
  [in] LPCSTR OldTargetName,
  [in] LPCSTR NewTargetName,
  [in] DWORD  Type,
  [in] DWORD  Flags
);

Parâmetros

[in] OldTargetName

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

[in] NewTargetName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o novo nome para a credencial.

[in] Type

Tipo da credencial a ser renomeada. Deve ser um dos CRED_TYPE_* define.

[in] Flags

Sinalizadores para controlar a operação da função. Atualmente 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 de status mais específico. Os seguintes códigos de status podem ser retornados:

  • ERROR_NOT_FOUND

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

  • ERROR_ALREADY_EXISTS

    Já existe uma credencial ou tipo Type e chamado NewTargetName.

  • 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

Observação

O cabeçalho wincred.h define CredRename como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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