WEKF_CustomKey.Adicionar

Edições
✅ com suporte IoT Enterprise LTSC
✅ IoT Enterprise
✅ Enterprise LTSC
✅ Enterprise
✅ Education

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

Sintaxe

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

Parâmetros

CustomKey
[em] A combinação de teclas personalizadas a ser adicionada. Para obter uma lista de nomes de teclas válidos, consulte Nomes de teclas do Filtro de Teclado.

Valor de retorno

Retorna um valor HRESULT que indica uma constante de não erro WMI ou uma constante de erro WMI.

Comentários

WEKF_CustomKey.Add cria um novo 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 novo 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 chave 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
    }
  • Last updated on