Compartilhar via


WEKF_Scancode

Bloqueia ou desbloqueia combinações de teclas usando o código de verificação do teclado, que é um número inteiro que é gerado sempre que uma tecla é pressionada ou liberada.

Sintaxe

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

Membros

As tabelas a seguir listam quaisquer construtores, métodos, campos e propriedades que pertencem a essa classe.

Métodos

Métodos Descrição
WEKF_Scancode.Adicionar Adiciona uma nova combinação de código de verificação personalizada e permite que o Filtro de Teclado bloqueie a nova combinação de código de verificação.
WEKF_Scancode.Remover Remove a combinação de código de verificação personalizada especificada. O Filtro de Teclado pára de bloquear a combinação de código de verificação que foi removida.

Propriedades

Propriedade Tipo de dados Qualificadores Descrição
Modificadores string [key] As teclas modificadoras que fazem parte da combinação de teclas a ser bloqueada.
Código de varredura uint16 [key] A parte do código de varredura da combinação de teclas a ser bloqueada.
Enabled Booliano [ler, escrever] Indica se o código de verificação está bloqueado ou desbloqueado. Essa propriedade pode ser um dos seguintes valores:
- true Indica que o código de verificação está bloqueado.
- false Indica que o código de verificação não está bloqueado.

Comentários

Os códigos de digitalização são gerados pelo teclado sempre que uma tecla é pressionada. A mesma tecla física sempre gerará o mesmo código de verificação, independentemente de qual layout de teclado está sendo usado atualmente pelo sistema.

Você pode especificar combinações de teclas incluindo as teclas modificadoras no parâmetro Modifiers do método Add ou modificando a propriedade Modifiers . Os nomes de modificadores mais comuns são "Ctrl", "Shift", "Alt" e "Win".

Exemplo

O código a seguir demonstra como adicionar ou habilitar um código de verificação de teclado que o filtro de teclado bloqueará usando os provedores WMI (Instrumentação de Gerenciamento do Windows) para filtro de teclado. Este exemplo modifica as propriedades diretamente e não chama nenhum dos métodos definidos em WEKF_Scancode.

<#
.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

Requisitos

Edição do Windows Com suporte
Windows Home Não
Windows Pro Não
Windows Enterprise Sim
Educação do Windows Sim
Windows IoT Enterprise Yes

Referência do provedor WMI do filtro de teclado

Filtro de teclado