Função CredRenameA (wincred.h)

Artigo
11/20/2024

[ CredRename não tem mais suporte. 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 é aquele 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 da credencial.

[in] Type

Tipo da credencial a ser renomeada. Deve ser uma das definições de CRED_TYPE_*.

[in] Flags

Sinalizadores para controlar a operação da função. Atualmente reservado e deve ser zero.

Valor de retorno

A função retorna TRUE com ê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 oOldTargetName especificado.
ERROR_ALREADY_EXISTS
Já existe uma credencial ou tipo Tipo e denominado 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.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wincred.h
biblioteca	Advapi32.lib
de DLL	Advapi32.dll

Compartilhar via