Función CredEnumerateW (wincred.h)
La función CredEnumerate enumera las credenciales del 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 CredEnumerateW(
[in] LPCWSTR Filter,
[in] DWORD Flags,
[out] DWORD *Count,
[out] PCREDENTIALW **Credential
);
Parámetros
[in] Filter
Puntero a una cadena terminada en null que contiene el filtro de las credenciales devueltas. Solo se devolverán las credenciales con un targetName que coincida con el filtro. El filtro especifica un prefijo de nombre seguido de un asterisco. Por ejemplo, el filtro "FRED*" devolverá todas las credenciales con targetName a partir de la cadena "FRED".
Si se especifica NULL , se devolverán todas las credenciales.
[in] Flags
El valor de este parámetro puede ser cero o más de los siguientes valores combinados con una operación OR bit a bit.
[out] Count
Recuento de las credenciales devueltas en la matriz De credenciales .
[out] Credential
Puntero a una matriz de punteros a credenciales. La credencial devuelta es un único bloque asignado. Los punteros contenidos en el búfer son punteros a ubicaciones dentro de este único bloque asignado. El único búfer devuelto debe liberarse llamando a CredFree.
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.
Código o valor devuelto | Descripción |
---|---|
|
No existe ninguna credencial que coincida con el filtro especificado. |
|
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. |
|
Se especificó una marca que no es válida para el parámetro Flags o CRED_ENUMERATE_ALL_CREDENTIALS para el parámetro Flags y el parámetro Filter no es NULL. |
Comentarios
Nota
El encabezado wincred.h define CredEnumerate 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o 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 |
Consulte también
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