Función CredRenameA (wincred.h)
[CredRename ya no se admite. A partir de Windows Vista, las llamadas a CredRename siempre devuelven ERROR_NOT_SUPPORTED.]
La función CredRename cambia el nombre de una credencial en el conjunto de credenciales del usuario. El conjunto de credenciales usado es el asociado a la sesión de inicio de sesión del token actual. El token no debe tener deshabilitado el SID del usuario.
Sintaxis
BOOL CredRenameA(
[in] LPCSTR OldTargetName,
[in] LPCSTR NewTargetName,
[in] DWORD Type,
[in] DWORD Flags
);
Parámetros
[in] OldTargetName
Puntero a una cadena terminada en null que contiene el nombre actual de la credencial cuyo nombre se va a cambiar.
[in] NewTargetName
Puntero a una cadena terminada en null que contiene el nuevo nombre de la credencial.
[in] Type
Tipo de la credencial cuyo nombre se va a cambiar. Debe ser uno de los CRED_TYPE_* definidos.
[in] Flags
Marcas para controlar la operación de la función. Actualmente reservado y debe ser cero.
Valor devuelto
La función devuelve TRUE si se ejecuta correctamente y FALSE en caso de error. Se puede llamar a la función GetLastError para obtener un código de estado más específico. Se pueden devolver los siguientes códigos de estado:
- ERROR_NOT_FOUND
No hay ninguna credencial con el OldTargetName especificado.
- ERROR_ALREADY_EXISTS
Ya hay una credencial o tipo Type y denominada NewTargetName.
- ERROR_NO_SUCH_LOGON_SESSION
La sesión de inicio de sesión no existe o no hay ningún conjunto de credenciales asociado a esta sesión de inicio de sesión. Las sesiones de inicio de sesión de red no tienen un conjunto de credenciales asociado.
- ERROR_INVALID_FLAGS
Se especificó una marca que no es válida para el parámetro Flags .
Comentarios
Nota
El encabezado wincred.h define CredRename como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | wincred.h |
Library | Advapi32.lib |
Archivo DLL | Advapi32.dll |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de