Funzione WinBioAcquireFocus (winbio.h)
Acquisisce lo stato attivo della finestra.
Sintassi
HRESULT WinBioAcquireFocus();
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 di codici di errore comuni, vedere Valori HRESULT comuni.
| Codice restituito | Descrizione |
|---|---|
|
Il processo di chiamata deve essere in esecuzione nell'account di sistema locale. |
Commenti
Windows Biometric Framework usa lo stato attivo della finestra per arbitare tra più sessioni connesse al pool di sistema.
Il modo in cui si acquisisce lo stato attivo dipende dal tipo di applicazione che si scrive. Ad esempio, se si sta creando un'applicazione GUI, è possibile implementare un gestore messaggi che acquisisce un WM_ACTIVATE, WM_SETFOCUS o un altro messaggio appropriato. Se si scrive un'applicazione CUI, chiamare GetConsoleWindow per recuperare un handle nella finestra della console e passare tale handle alla funzione SetForegroundWindow per forzare la finestra della console in primo piano e assegnarla lo stato attivo. Se l'applicazione è in esecuzione in un processo scollegato o è un servizio Windows e non ha alcuna finestra, usare WinBioAcquireFocus e WinBioReleaseFocus per controllare manualmente lo stato attivo.
L'elenco seguente riepiloga i punti principali da considerare prima di chiamare questa funzione.
- Il processo di chiamata deve essere in esecuzione nell'account di sistema locale.
- Un processo che visualizza direttamente un'interfaccia utente non deve chiamare questa funzione. Vedere la discussione precedente per determinare come acquisire lo stato attivo per le applicazioni GUI e CUI.
- Solo un servizio o un processo scollegato che non visualizza direttamente un'interfaccia utente durante le chiamate API biometriche deve chiamare questa funzione.
- Se la funzione ha esito positivo, è necessario chiamare WinBioReleaseFocus per rilasciare lo stato attivo.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |