Función CredEnumerateA (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 CredEnumerateA(
  [in]  LPCSTR       Filter,
  [in]  DWORD        Flags,
  [out] DWORD        *Count,
  [out] PCREDENTIALA **Credential
);

Parámetros

[in] Filter

Puntero a un cadenaterminada en null que contiene el filtro para las credenciales devueltas. Solo se devolverán las credenciales con un TargetName que coincidan con el filtro. El filtro especifica un prefijo de nombre seguido de un asterisco. Por ejemplo, el filtro "FRED*" devolverá todas las credenciales con un 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 abit.

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, la función produce un error y 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 de .

[out] Credential

Puntero a una matriz de punteros a las 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 y valor devueltos	Descripción
ERROR_NOT_FOUND 1168 (0x490)	No existe ninguna credencial que coincida con el filtro de 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 se especifica CRED_ENUMERATE_ALL_CREDENTIALS para el parámetro Flags y el parámetro Filter no es NULL.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wincred.h
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll

Consulte también

CredFree

GetLastError