Función CredEnumerateA (wincred.h)

  • Artículo

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 CredEnumerateA(
  [in]  LPCSTR       Filter,
  [in]  DWORD        Flags,
  [out] DWORD        *Count,
  [out] PCREDENTIALA **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.

Valor Significado
CRED_ENUMERATE_ALL_CREDENTIALS
0x1
 Esta función enumera todas las credenciales del conjunto de credenciales del usuario. El nombre de destino de cada credencial se devuelve en el formato "namespace:attribute=target". Si se establece esta marca y el parámetro Filter no es NULL, se produce un error en la función y se devuelve ERROR_INVALID_FLAGS.

Windows Server 2003 y Windows XP: Esta marca no se admite.

[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
ERROR_NOT_FOUND
1168 (0x490)
 No existe ninguna credencial que coincida con el filtro especificado.
ERROR_NO_SUCH_LOGON_SESSION
1312 (0x520)
 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
1004 (0x3EC)
 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

CredFree

Obtener último error