Funzione WinBioOpenSession (winbio.h)

Articolo
03/08/2023

Si connette a un provider di servizi biometrici e a una o più unità biometriche.

Sintassi

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
);

Parametri

[in] Factor

Maschera di bit di flag WINBIO_BIOMETRIC_TYPE che specifica i tipi di unità biometrica da enumerare. Attualmente è supportato solo WINBIO_TYPE_FINGERPRINT .

[in] PoolType

Valore ULONG che specifica il tipo di unità biometriche che verranno utilizzate nella sessione. I valori possibili sono i seguenti:

Valore	Significato
WINBIO_POOL_SYSTEM	La sessione si connette a una raccolta condivisa di unità biometriche gestite dal provider di servizi.
WINBIO_POOL_PRIVATE	La sessione si connette a una raccolta di unità biometriche gestite dal chiamante.

[in] Flags

Valore ULONG che specifica le caratteristiche di configurazione e accesso dell'unità biometrica per la nuova sessione. I flag di configurazione specificano la configurazione generale delle unità nella sessione. I flag di accesso specificano il modo in cui l'applicazione userà le unità biometriche. È necessario specificare un flag di configurazione, ma è possibile combinare tale flag con qualsiasi flag di accesso.

Valore	Significato
WINBIO_FLAG_DEFAULT	Gruppo: configurazione Le unità biometriche operano nel modo specificato durante l'installazione. È necessario usare questo valore quando il parametro PoolType è WINBIO_POOL_SYSTEM.
WINBIO_FLAG_BASIC	Gruppo: configurazione Le unità biometriche funzionano solo come dispositivi di acquisizione di base. Tutte le operazioni di elaborazione, corrispondenza e archiviazione vengono eseguite dai plug-in software.
WINBIO_FLAG_ADVANCED	Gruppo: configurazione Le unità biometriche usano funzionalità di elaborazione e archiviazione interne.
WINBIO_FLAG_RAW	Gruppo: accesso L'applicazione client acquisisce dati biometrici non elaborati usando WinBioCaptureSample.
WINBIO_FLAG_MAINTENANCE	Gruppo: accesso Il client esegue operazioni di controllo definite dal fornitore su un'unità biometrica chiamando WinBioControlUnitPrivileged.

[in] UnitArray

Puntatore a una matrice di identificatori di unità biometrica da includere nella sessione. Puoi chiamare WinBioEnumBiometricUnits per enumerare le unità biometriche. Impostare questo valore su NULL se il parametro PoolType è WINBIO_POOL_SYSTEM.

[in] UnitCount

Valore che specifica il numero di elementi nella matrice a cui punta il parametro UnitArray . Impostare questo valore su zero se il parametro PoolType è WINBIO_POOL_SYSTEM.

[in] DatabaseId

Valore che specifica i database da utilizzare dalla sessione. Se il parametro PoolType è WINBIO_POOL_PRIVATE, è necessario specificare il GUID di un database installato. Se il parametro PoolType non è WINBIO_POOL_PRIVATE, è possibile specificare uno dei valori comuni seguenti.

Valore	Significato
WINBIO_DB_DEFAULT	Ogni unità biometrica nel pool di sensori usa il database predefinito specificato nella configurazione predefinita dell'unità biometrica. È necessario specificare questo valore se il parametro PoolType è WINBIO_POOL_SYSTEM. Non è possibile usare questo valore se il parametro PoolType è WINBIO_POOL_PRIVATE
WINBIO_DB_BOOTSTRAP	È possibile specificare questo valore da usare per gli scenari prima di avviare Windows. In genere, il database fa parte del chip del sensore o fa parte del BIOS e può essere usato solo per la registrazione e l'eliminazione del modello.
WINBIO_DB_ONCHIP	Il database si trova nel chip del sensore ed è disponibile per la registrazione e la corrispondenza.

[out] SessionHandle

Puntatore al nuovo handle di sessione. Se la funzione non riesce, l'handle viene impostato su zero.

Valore restituito

Se la funzione ha esito positivo, restituisce S_OK. Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti hanno valori non corretti o sono incompatibili con altri argomenti.
E_POINTER	Il puntatore dell'handle di sessione nel parametro SessionHandle non può essere NULL.
E_ACCESSDENIED	Il parametro Flags contiene il WINBIO_FLAG_RAW o il flag di WINBIO_FLAG_MAINTENANCE e al chiamante non è stata concessa alcuna autorizzazione di accesso.
WINBIO_E_INVALID_UNIT	Uno o più numeri di unità biometrica specificati nel parametro UnitArray non sono validi.
WINBIO_E_NOT_ACTIVE_CONSOLE	L'applicazione client è in esecuzione in un client desktop remoto e tenta di aprire una sessione del pool di sistema.
WINBIO_E_SENSOR_UNAVAILABLE	Il parametro PoolType è impostato su WINBIO_POOL_PRIVATE e uno o più sensori richiesti in tale pool non sono disponibili.
WINBIO_E_DISABLED	I criteri amministrativi correnti impediscono l'uso dell'API Di Windows Biometric Framework.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbio.h (include Winbio.h)
Libreria	Winbio.lib
DLL	Winbio.dll

Vedi anche

WinBioCloseSession

Condividi tramite