WEKF_CustomKey.Add

Crea una nueva combinación de teclas personalizada y permite al filtro de teclado bloquear la nueva combinación de teclas.

Sintaxis

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

Parámetros

CustomKey
[in] Combinación de teclas personalizada que se va a agregar. Para obtener una lista de nombres de clave válidos, consulte Nombres de clave de filtro de teclado.

Valor devuelto

Devuelve un valor HRESULT que indica una constante de error de WMI o una constante de error de WMI.

Comentarios

WEKF_CustomKey.Add crea un nuevo objeto WEKF_CustomKey y establece la propiedad Enabled del nuevo objeto en true y la propiedad Id en CustomKey.

Si ya existe un objeto WEKF_CustomKey con la propiedad Id igual a CustomKey, WEKF_CustomKey.Add devuelve un código de error y no crea un nuevo objeto ni modifica ninguna propiedad del objeto existente. Si el objeto WEKF_CustomKey existente tiene la propiedad Enabled establecida en false, El filtro de teclado no bloquea la combinación de teclas personalizada.

Ejemplo

En el código siguiente se muestra cómo agregar o habilitar una tecla personalizada que el filtro de teclado bloqueará mediante los proveedores de Instrumental de administración de Windows (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 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

Edición de Windows Compatible
Windows 10 Home No
Windows 10 Pro No
Windows 10 Enterprise
Windows 10 Education

WEKF_CustomKey

Keyboard Filter