AccSetRunningUtilityState-Funktion (oleacc.h)

Artikel
02/29/2024

Legt Systemwerte fest, die angeben, ob der aktuelle Zustand einer Hilfstechnologieanwendung (AT) sich auf die Funktionalität auswirkt, die normalerweise vom System bereitgestellt wird.

Syntax

HRESULT AccSetRunningUtilityState(
  [in] HWND  hwndApp,
  [in] DWORD dwUtilityStateMask,
  [in] DWORD dwUtilityState
);

Parameter

[in] hwndApp

Typ: HWND

Das Handle des AT-Anwendungsfensters. Dieser Parameter darf nicht NULL sein.

[in] dwUtilityStateMask

Art: DWORD

Ein
Mask, die die festzulegenden Systemwerte angibt. Es kann sich um eine Kombination der folgenden Werte handeln:

ANRUS_ON_SCREEN_KEYBOARD_ACTIVE

ANRUS_TOUCH_MODIFICATION_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK

[in] dwUtilityState

Art: DWORD

Die neuen Einstellungen für die Systemwerte, die von dwUtilityStateMask angegeben werden. Dieser Parameter kann null sein, um die Systemwerte zurückzusetzen, oder eine Kombination der folgenden Werte.

Wert	Bedeutung
ANRUS_ON_SCREEN_KEYBOARD_ACTIVE 0x0000001	Die AT-Anwendung stellt eine Bildschirmtastatur bereit.
ANRUS_TOUCH_MODIFICATION_ACTIVE 0x0000002	Die AT-Anwendung verwendet umgeleitete Toucheingaben.
ANRUS_PRIORITY_AUDIO_ACTIVE 0x0000004	Die AT-Anwendung verwendet Audio (z. B. Sprachsynthese), um dem Benutzer wichtige Informationen zu vermitteln, und sollte gegenüber anderen Systemsounds hörbar bleiben.
ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK 0x0000008	Die AT-Anwendung verwendet Audiodaten (z. B. Sprachsynthese), um dem Benutzer wichtige Informationen zu vermitteln, sollte sich jedoch im Verhältnis zu anderen Systemsounds nicht ändern.

Rückgabewert

Typ: STDAPI

Gibt bei Erfolg S_OK zurück.

Wenn dies nicht erfolgreich ist, wird ein COM-Standardfehlercode zurückgegeben.

Hinweise

Bevor sie beendet wird, sollte eine AT-Anwendung alle zuvor festgelegten Systemwerte zurücksetzen.

Diese Funktion erfordert, dass der aufrufende Prozess über UIAccess oder höhere Berechtigungen verfügt. Wenn der Aufrufer nicht über die erforderlichen Berechtigungen verfügt, schlägt der Aufruf von AccSetRunningUtilityState fehl und gibt E_ACCESSDENIED zurück. Weitere Informationen finden Sie unter Sicherheitsüberlegungen für Hilfstechnologien und /MANIFESTUAC (Einbetten von UAC-Informationen in Manifest).

Beispiele

In diesem Codebeispiel wird gezeigt, wie die AccSetRunningUtilityState-Funktion aufgerufen wird.

if (SUCCEEDED(hr))
{
    // Tell the system that an AT application has registered with the 
    // touch redirector.
    hr = AccSetRunningUtilityState(hwndTouchWindow, 
            ANRUS_TOUCH_MODIFICATION_ACTIVE, 
            ANRUS_TOUCH_MODIFICATION_ACTIVE);
    if (FAILED(hr))
    {
        MyErrorHandler(hr); // Application-defined error handler
    }
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleacc.h
Bibliothek	Oleacc.lib
DLL	Oleacc.dll

Weitere Informationen

Sicherheitsüberlegungen für Hilfstechnologien

Share via