Función WinBioOpenSession (winbio.h)

  • Artículo

Se conecta a un proveedor de servicios biométricos y a una o varias unidades biométricas.

Sintaxis

HRESULT WinBioOpenSession(
  [in]  WINBIO_BIOMETRIC_TYPE Factor,
  [in]  WINBIO_POOL_TYPE      PoolType,
  [in]  WINBIO_SESSION_FLAGS  Flags,
  [in]  WINBIO_UNIT_ID        *UnitArray,
  [in]  SIZE_T                UnitCount,
  [in]  GUID                  *DatabaseId,
  [out] WINBIO_SESSION_HANDLE *SessionHandle
);

Parámetros

[in] Factor

Máscara de bits de marcas de WINBIO_BIOMETRIC_TYPE que especifica los tipos de unidad biométrica que se van a enumerar. Actualmente solo se admite WINBIO_TYPE_FINGERPRINT .

[in] PoolType

Valor ULONG que especifica el tipo de las unidades biométricas que se usarán en la sesión. Puede ser uno de los siguientes valores:

Value Significado
WINBIO_POOL_SYSTEM
 La sesión se conecta a una colección compartida de unidades biométricas administradas por el proveedor de servicios.
WINBIO_POOL_PRIVATE
 La sesión se conecta a una colección de unidades biométricas administradas por el autor de la llamada.

[in] Flags

Valor ULONG que especifica la configuración de unidades biométricas y las características de acceso para la nueva sesión. Las marcas de configuración especifican la configuración general de unidades en la sesión. Las marcas de acceso especifican cómo usará la aplicación las unidades biométricas. Debe especificar una marca de configuración, pero puede combinar esa marca con cualquier marca de acceso.

Value Significado
WINBIO_FLAG_DEFAULT
 Grupo: configuración

Las unidades biométricas funcionan de la manera especificada durante la instalación. Debe usar este valor cuando se WINBIO_POOL_SYSTEM el parámetro PoolType .
WINBIO_FLAG_BASIC
 Grupo: configuración

Las unidades biométricas solo funcionan como dispositivos de captura básicos. Todos los complementos de software realizan todas las operaciones de procesamiento, coincidencia y almacenamiento.
WINBIO_FLAG_ADVANCED
 Grupo: configuración

Las unidades biométricas usan funcionalidades de procesamiento interno y almacenamiento.
WINBIO_FLAG_RAW
 Grupo: acceso

La aplicación cliente captura datos biométricos sin procesar mediante WinBioCaptureSample.
WINBIO_FLAG_MAINTENANCE
 Grupo: acceso

El cliente realiza operaciones de control definidas por el proveedor en una unidad biométrica mediante una llamada a WinBioControlUnitPrivileged.

[in] UnitArray

Puntero a una matriz de identificadores de unidad biométrica que se incluirán en la sesión. Puedes llamar a WinBioEnumBiometricUnits para enumerar las unidades biométricas. Establezca este valor en NULL si el parámetro PoolType está WINBIO_POOL_SYSTEM.

[in] UnitCount

Valor que especifica el número de elementos de la matriz a los que apunta el parámetro UnitArray . Establezca este valor en cero si el parámetro PoolType es WINBIO_POOL_SYSTEM.

[in] DatabaseId

Valor que especifica las bases de datos que va a usar la sesión. Si el parámetro PoolType es WINBIO_POOL_PRIVATE, debe especificar el GUID de una base de datos instalada. Si el parámetro PoolType no es WINBIO_POOL_PRIVATE, puede especificar uno de los siguientes valores comunes.

Value Significado
WINBIO_DB_DEFAULT
 Cada unidad biométrica del grupo de sensores usa la base de datos predeterminada especificada en la configuración de unidad biométrica predeterminada. Debe especificar este valor si el parámetro PoolType es WINBIO_POOL_SYSTEM. No puede usar este valor si el parámetro PoolType es WINBIO_POOL_PRIVATE
WINBIO_DB_BOOTSTRAP
 Puede especificar este valor que se usará para escenarios antes de iniciar Windows. Normalmente, la base de datos forma parte del chip del sensor o forma parte del BIOS y solo se puede usar para la inscripción y eliminación de plantillas.
WINBIO_DB_ONCHIP
 La base de datos está en el chip del sensor y está disponible para la inscripción y la coincidencia.

[out] SessionHandle

Puntero al nuevo identificador de sesión. Si la función no se realiza correctamente, el identificador se establece en cero.

Valor devuelto

Si la función se realiza correctamente, devuelve S_OK. Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código devuelto Descripción
E_INVALIDARG
 Uno o varios argumentos tienen valores incorrectos o son incompatibles con otros argumentos.
E_POINTER
 El puntero de identificador de sesión del parámetro SessionHandle no puede ser NULL.
E_ACCESSDENIED
 El parámetro Flags contiene el WINBIO_FLAG_RAW o la marca WINBIO_FLAG_MAINTENANCE y no se le ha concedido permiso de acceso al autor de la llamada.
WINBIO_E_INVALID_UNIT
 Uno o varios de los números de unidad biométrica especificados en el parámetro UnitArray no son válidos.
WINBIO_E_NOT_ACTIVE_CONSOLE
 La aplicación cliente se ejecuta en un cliente de Escritorio remoto e intenta abrir una sesión del grupo de sistemas.
WINBIO_E_SENSOR_UNAVAILABLE
 El parámetro PoolType se establece en WINBIO_POOL_PRIVATE y uno o varios de los sensores solicitados en ese grupo no están disponibles.
WINBIO_E_DISABLED
 La directiva administrativa actual prohíbe el uso de la API de Windows Biometric Framework.

Requisitos

   
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbio.h (incluye Winbio.h)
Library Winbio.lib
Archivo DLL Winbio.dll

Consulte también

WinBioCloseSession