Partilhar via

WEKF_CustomKey.Add

  • Artigo
  • Aplica-se a:
    ✅ Windows 11, ✅ Windows 10

Cria uma combinação de teclas personalizadas e permite que o Filtro de Teclado bloqueie a nova combinação de teclas.

Sintaxe

[Static] uint32 Add(
    [In] string CustomKey
);

Parâmetros

CustomKey
[in] A combinação de teclas personalizada a ser adicionada. Para obter uma lista de nomes de teclas válidos, confira Nomes de teclas de filtro de teclado.

Valor Retornado

Retorna um valor HRESULT que indica uma constante WMI sem erro ou uma constante de erro WMI.

Comentários

WEKF_CustomKey.Add cria um objeto WEKF_CustomKey e define a propriedade Enabled do novo objeto como true e a propriedade Id como CustomKey.

Se um objeto WEKF_CustomKey já existir com a propriedade Id igual a CustomKey, WEKF_CustomKey.Add retornará um código de erro e não criará um objeto nem modificará nenhuma propriedade do objeto existente. Se o objeto WEKF_CustomKey existente tiver a propriedade Enabled definida como false, o Filtro de Teclado não bloqueará a combinação de teclas personalizadas.

Exemplo

O código a seguir demonstra como adicionar ou habilitar uma tecla personalizada que o Filtro de Teclado bloqueará usando os provedores WMI (Instrumentação de Gerenciamento do Windows) para Filtro de Teclado.

$COMPUTER = "localhost"
$NAMESPACE = "root\standardcimv2\embedded"

# Create a handle to the class instance so we can call the static methods
$classCustomKey = [wmiclass]"\\$COMPUTER\${NAMESPACE}:WEKF_CustomKey"

# Create a function to add or enable a key combination for Keyboard Filter to block
function Enable-Custom-Key($KeyId) {

# Check to see if the custom key object already exists
    $objCustomKey = Get-WMIObject -namespace $NAMESPACE -class WEKF_CustomKey |
            where {$_.Id -eq "$KeyId"};

    if ($objCustomKey) {

# The custom key already exists, so just enable it
        $objCustomKey.Enabled = 1;
        $objCustomKey.Put() | Out-Null;
        "Enabled ${KeyId}.";

    } else {

# Create a new custom key object by calling the static Add method
        $retval = $classCustomKey.Add($KeyId);

# Check the return value to verify that the Add is successful
        if ($retval.ReturnValue -eq 0) {
            "Added ${KeyID}."
        } else {
            "Unknown Error: " + "{0:x0}" -f $retval.ReturnValue
        }
    }
}

# Enable Keyboard Filter to block several custom keys

Enable-Custom-Key "Ctrl+v"
Enable-Custom-Key "Ctrl+v"
Enable-Custom-Key "Shift+4"
Enable-Custom-Key "Ctrl+Alt+w"

# List all the currently existing custom keys

$objCustomKeyList = get-WMIObject -namespace $NAMESPACE -class WEKF_CustomKey
foreach ($objCustomKeyItem in $objCustomKeyList) {
    "Custom key: " + $objCustomKeyItem.Id
    "   enabled: " + $objCustomKeyItem.Enabled
    }

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