WEKF_Scancode

Blockiert oder entsperrt Tastenkombinationen mithilfe des Tastaturscancodes, der eine ganze Zahl ist, die generiert wird, wenn eine Taste gedrückt oder losgelassen wird.

Syntax

class WEKF_Scancode {
    [Static] uint32 Add(
        [In] string Modifiers,
        [In] uint16 scancode
    );
    [Static] uint32 Remove(
        [In] string Modifiers,
        [In] uint16 Scancode
    );

    [Key] string Modifiers;
    [Key] uint16 Scancode;
    [Read, Write] boolean Enabled;
}

Member

In den folgenden Tabellen sind alle Methoden und Eigenschaften aufgeführt, die zu dieser Klasse gehören.

Methoden

Methoden	BESCHREIBUNG
WEKF_Scancode.Add	Fügt eine neue benutzerdefinierte Scancodekombination hinzu und ermöglicht dem Tastaturfilter das Blockieren der neuen Scancodekombination.
WEKF_Scancode.Remove	Entfernt die angegebene benutzerdefinierte Scancodekombination. Der Tastaturfilter blockiert nicht mehr die Kombination aus Scancode, die entfernt wurde.

Eigenschaften

Eigenschaft	Datentyp	Qualifizierer	BESCHREIBUNG
Modifizierer	Zeichenfolge	[Taste]	Die Modifizierertasten, die Teil der Tastenkombination sind, die blockiert werden sollen.
Scancode	uint16	[Taste]	Der Scancode-Teil der Tastenkombination, die blockiert werden soll.
Aktiviert	Boolean	[lesen, schreiben]	Gibt an, ob der Scancode blockiert oder freigegeben ist. Diese Eigenschaft kann einer der folgenden Werte sein: - true Gibt an, dass der Scancode blockiert ist. - FALSE Gibt an, dass der Scancode nicht blockiert ist.

Bemerkungen

Scancodes werden von der Tastatur generiert, wenn eine Taste gedrückt wird. Die gleiche physische Taste generiert immer denselben Scancode, unabhängig davon, welches Tastaturlayout derzeit vom System verwendet wird.

Sie können Tastenkombinationen angeben, indem Sie die Modifizierertasten im Parameter Modifizierer der Hinzufügen-Methode einfügen oder die Eigenschaft Modifizierer ändern. Die häufigsten Modifizierernamen sind „STRG“, „Umschalt“, „Alt“ und „Win“.

Beispiel

Der folgende Code veranschaulicht, wie Sie einen Tastaturscancode hinzufügen oder aktivieren, den der Tastaturfilter mithilfe der WMI-Anbieter (Windows-Verwaltungsinstrumentation) für den Tastaturfilter blockiert. In diesem Beispiel werden die Eigenschaften direkt geändert und keine der in WEKF_Scancode definierten Methoden aufgerufen.

<#
.Synopsis
    This script shows how to use the WMI provider to enable and add 
    Keyboard Filter rules through Windows Powershell on the local computer.
.Parameter ComputerName
    Optional parameter to specify a remote machine that this script should
    manage.  If not specified, the script will execute all WMI operations
    locally.
#>
param (
    [String] $ComputerName
)

$CommonParams = @{"namespace"="root\standardcimv2\embedded"}
$CommonParams += $PSBoundParameters


function Enable-Scancode($Modifiers, [int]$Code) {
    <#
    .Synopsis
        Toggle on a Scancode Keyboard Filter Rule
    .Description
        Use Get-WMIObject to enumerate all WEKF_Scancode instances,
        filter against key values of "Modifiers" and "Scancode", and set
        that instance's "Enabled" property to 1/true.

        In the case that the Scancode instance does not exist, add a new
        instance of WEKF_Scancode using Set-WMIInstance.
    .Example
        Enable-Predefined-Key "Ctrl+V"

        Enable filtering of the Ctrl + V sequence.
#>

    $scancode =
        Get-WMIObject -class WEKF_Scancode @CommonParams |
            where {
                ($_.Modifiers -eq $Modifiers) -and ($_.Scancode -eq $Code)
            }

    if($scancode) {
        $scancode.Enabled = 1
        $scancode.Put() | Out-Null
        "Enabled Custom Scancode {0}+{1:X4}" -f $Modifiers, $Code
    } else {
        Set-WMIInstance `
            -class WEKF_Scancode `
            -argument @{Modifiers="$Modifiers"; Scancode=$Code} `
            @CommonParams | Out-Null
 
        "Added Custom Scancode {0}+{1:X4}" -f $Modifiers, $Code
    }
}

# Some example uses of the function defined above.

Enable-Scancode "Ctrl" 37

Anforderungen

Windows-Edition	Unterstützt
Windows Home	Nein
Windows Pro	Nein
Windows Enterprise	Ja
Windows Education	Ja
Windows IoT Enterprise	Ja

Zugehörige Themen

WMI-Anbieterreferenz für Tastaturfilter

Tastaturfilter