Funzione WinBioReleaseFocus (winbio.h)

Rilascia lo stato attivo della finestra.

Sintassi

HRESULT WinBioReleaseFocus();

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.

Commenti

Windows Biometric Framework usa lo stato attivo della finestra per abitrate 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 di messaggi che acquisisce un WM_ACTIVATE, un 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 finestra, usare WinBioAcquireFocus e WinBioReleaseFocus per controllare manualmente lo stato attivo.

L'elenco seguente riepiloga i punti principali da considerare prima di chiamare WinBioAcquireFocus e WinBioReleaseFocus.

• Il processo chiamante deve essere in esecuzione con l'account di sistema locale.
• Un processo che visualizza direttamente un'interfaccia utente non deve chiamare WinBioAcquireFocus. 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.

• WinBioEnrollBegin
• WinBioEnrollCapture
• WinBioEnrollCaptureWithCallback

Requisiti

Vedi anche

Funzioni dell'applicazione client

WinBioEnrollBegin