Compartir a través de

Método ICredentialProvider::GetCredentialCount (credentialprovider.h)

  • Artículo

Obtiene el número de credenciales disponibles en este proveedor de credenciales.

Sintaxis

HRESULT GetCredentialCount(
  [out] DWORD *pdwCount,
  [out] DWORD *pdwDefault,
  [out] BOOL  *pbAutoLogonWithDefault
);

Parámetros

[out] pdwCount

Tipo: DWORD*

Puntero a un valor DWORD que recibe el recuento de credenciales.

[out] pdwDefault

Tipo: DWORD*

Puntero a un valor DWORD que recibe el índice de la credencial que se va a usar como valor predeterminado. Si no se ha establecido ningún valor predeterminado, este valor debe establecerse en CREDENTIAL_PROVIDER_NO_DEFAULT.

[out] pbAutoLogonWithDefault

Tipo: BOOL*

Puntero a un valor BOOL que indica si se debe usar la credencial predeterminada identificada por pdwDefault para un intento de inicio de sesión automático. Un intento de inicio de sesión automático significa que la interfaz de usuario de inicio de sesión o la interfaz de usuario de credenciales llamarán inmediatamente a GetSerialization en el icono predeterminado del proveedor.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método es necesario.

Cuando una interfaz de usuario de inicio de sesión o una interfaz de usuario de credenciales está lista para la interacción del usuario, se selecciona una credencial predeterminada de forma predeterminada. Dado que cada proveedor de credenciales proporciona una credencial predeterminada, las reglas siguientes determinan si pdwDefault recibirá el foco o si la credencial se registrará automáticamente.

  • Si ya se ha especificado una credencial predeterminada, esa credencial no está pensada para el inicio de sesión automático y el pdwDefault se usa para el inicio de sesión automático, se usará pdwDefault como valor predeterminado.
  • Si pdwDefault es del último proveedor que ha iniciado sesión y aún no hay un valor predeterminado con el inicio de sesión automático, se usará pdwDefault como valor predeterminado.
  • Si no se ha especificado ningún valor predeterminado, se usará pdwDefault como valor predeterminado.
Si cambia el número de credenciales válidas, el proveedor de credenciales debe llamar a CredentialsChanged en la instancia de ICredentialProviderEvents proporcionada en Advise.

Procedimientos recomendados del proveedor de credenciales

Los proveedores de credenciales controlan secretos de usuario extremadamente confidenciales para completar las solicitudes de inicio de sesión y desbloqueo. Como procedimiento recomendado, la información secreta, como las contraseñas y los PIN, debe controlarse con el máximo cuidado. Las técnicas adecuadas para controlar la información secreta dentro de un proveedor de credenciales son:
  • Descartar siempre los secretos de forma segura. Para ello, llame a SecureZeroMemory antes de liberar la memoria usada para contener cualquier secreto.
  • Descarte los secretos de forma segura inmediatamente después de que se usen.
  • Descarte de forma segura los secretos si no se usan para su propósito previsto dentro de un período de tiempo esperado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado credentialprovider.h