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

Define los escenarios para los que el proveedor de credenciales es válido. Se llama cada vez que se inicializa el proveedor de credenciales.

Sintaxis

HRESULT SetUsageScenario(
  [in] CREDENTIAL_PROVIDER_USAGE_SCENARIO cpus,
  [in] DWORD                              dwFlags
);

Parámetros

[in] cpus

Tipo: CREDENTIAL_PROVIDER_USAGE_SCENARIO

Escenario en el que se ha creado el proveedor de credenciales. Este es el escenario de uso que debe admitirse. Vea la sección Comentarios para obtener más información.

[in] dwFlags

Tipo: DWORD

Valor que afecta al comportamiento del proveedor de credenciales. Este valor puede ser una combinación or bit a bit de uno o varios de los siguientes valores definidos en Wincred.h. Consulte CredUIPromptForWindowsCredentials para obtener más información.

CREDUIWIN_GENERIC (0x00000001)

0x00000001. El autor de la llamada solicita que el proveedor de credenciales devuelva el nombre de usuario y la contraseña en texto sin formato. Este valor no se puede combinar con CREDUIWIN_SECURE_PROMPT.

CREDUIWIN_CHECKBOX (0x00000002)

0x00000002. La casilla Guardar se muestra en el cuadro de diálogo.

CREDUIWIN_AUTHPACKAGE_ONLY (0x00000010)

0x00000010. Solo se deben enumerar los proveedores de credenciales que admiten el paquete de autenticación de entrada. Si los proveedores de credenciales no admiten el paquete de autenticación de entrada, deben enumerar cero iconos de usuario. Este valor no se puede combinar con CREDUIWIN_IN_CRED_ONLY.

CREDUIWIN_IN_CRED_ONLY (0x00000020)

0x00000020. Si el proveedor puede serializar las credenciales, debe enumerar un icono para esa credencial. No se debe enumerar ningún otro mosaico. Los proveedores de credenciales deben usar el CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION de entrada en ICredentialProvider::SetSerialization y dwFlags en ICredentialProvider::SetUsageScenario para determinar cuántos iconos de credenciales se van a enumerar. Este valor no se puede combinar con CREDUIWIN_AUTHPACKAGE_ONLY.

CREDUIWIN_ENUMERATE_ADMINS (0x00000100)

0x00000100. Los proveedores de credenciales solo deben enumerar los administradores. Este valor solo está pensado para fines UAC. Se recomienda que los autores de llamadas externos no establezcan esta marca.

CREDUIWIN_ENUMERATE_CURRENT_USER (0x00000200)

0x00000200. Los proveedores de credenciales deben enumerar un icono para el usuario que ha iniciado sesión actualmente.

CREDUIWIN_SECURE_PROMPT (0x00001000)

0x00001000. El cuadro de diálogo de credenciales debe mostrarse en el escritorio seguro. Este valor no se puede combinar con CREDUIWIN_GENERIC. Los implementadores del proveedor de credenciales pueden omitir de forma segura esta marca.

CREDUIWIN_PACK_32_WOW (0x10000000)

0x10000000. Los búferes pasados al proveedor son de 32 bits. Los búferes devueltos por el proveedor también deben ser de 32 bits. Esto es necesario para WOW64.

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 y permite al proveedor de credenciales indicar cómo se usará.

Este método debe devolver E_NOTIMPL si se completa la llamada, pero no se admite el escenario de uso solicitado. Este método debe devolver S_OK si el método es correcto y se admite el escenario de uso.

Requisitos