Función CredFindBestCredentialA (wincred.h)

La función CredFindBestCredential busca en la base de datos de administración de credenciales de (CredMan) para el conjunto de credenciales genéricas asociadas a la sesión de inicio de sesión actual y que mejor coincidan con el recurso de destino especificado.

Sintaxis

BOOL CredFindBestCredentialA(
  [in]  LPCSTR       TargetName,
  [in]  DWORD        Type,
  [in]  DWORD        Flags,
  [out] PCREDENTIALA *Credential
);

Parámetros

[in] TargetName

Puntero a una cadena terminada en null que contiene el nombre del recurso de destino para el que se van a buscar credenciales.

[in] Type

Tipo de credenciales que se van a buscar. Actualmente, esta función solo admite CRED_TYPE_GENERIC.

[in] Flags

Reservado.

[out] Credential

Dirección de un puntero a una estructura CREDENTIAL que especifica el conjunto de credenciales que encuentra esta función.

Cuando haya terminado de usar esta estructura, puede liberarla llamando a la función CredFree.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Nota

El encabezado wincred.h define CredFindBestCredential 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 Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wincred.h
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll