Compartir a través de

WEKF_CustomKey.Remove

  • Artículo
  • Se aplica a:
    ✅ Windows 11, ✅ Windows 10

Quita una combinación de teclas personalizada, lo que hace que el filtro de teclado deje de bloquear la combinación de teclas eliminada.

Sintaxis

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

Parámetros

CustomKey
[in] Combinación de teclas personalizada que se va a quitar.

Valor devuelto

Devuelve un valor HRESULT que indica el estado de WMI o un error de WMI.

Comentarios

WEKF_CustomKey.Remove quita un objeto WEKF_CustomKey existente. Si el objeto no existe, WEKF_CustomKey.Remove devuelve un error con el valor 0x8007007B.

Dado que este método es estático, no puede llamarlo en una instancia de objeto, sino que debe llamarlo en el nivel de clase.

Ejemplo

En el código siguiente se muestra cómo quitar una tecla personalizada del filtro de teclado para que ya no esté bloqueada mediante los proveedores de Windows Management Instrumentation (WMI) para el 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 remove a key combination
function Remove-Custom-Key($KeyId) {

# Call the static Remove() method on the class reference
    $retval = $classCustomKey.Remove($KeyId)

# Check the return value for status
    if ($retval.ReturnValue -eq 0) {

# Custom key combination removed successfully
        "Removed ${KeyID}."
    } elseif ($retval.ReturnValue -eq 2147942523) {

# No object exists with the specified custom key
        "Failed to remove ${KeyID}. No object found."
    } else {

# Unknown error, report error code in hexadecimal
        "Failed to remove ${KeyID}. Unknown Error: " + "{0:x0}" -f $retval.ReturnValue
    }
}


# Example of removing a custom key so that Keyboard Filter stops blocking it
Remove-Custom-Key "Ctrl+Alt+w"

# Example of removing all custom keys that have the Enabled property set to false
$objDisabledCustomKeys = Get-WmiObject -Namespace $NAMESPACE -Class WEKF_CustomKey;

foreach ($objCustomKey in $objDisabledCustomKeys) {
    if (!$objCustomKey.Enabled) {
        Remove-Custom-Key($objCustomKey.Id);
    }
}

Requisitos

Edición de Windows Compatible
Windows Home No
Windows Pro No
Windows Enterprise Sí
Windows Education Sí
Windows IoT Enterprise Sí