Partager via

WEKF_CustomKey.Remove

Éditions
✅ prises en charge IoT Enterprise LTSC
✅ IoT Enterprise
✅ LTSC✅
Enterprise
✅ Éducation

Supprime une combinaison de touches personnalisée, ce qui empêche le filtre clavier de bloquer la combinaison de touches supprimée.

Syntaxe

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

Paramètres

CustomKey
[in] Combinaison de touches personnalisée à supprimer.

Valeur renvoyée

Retourne une valeur HRESULT qui indique une status WMI ou une erreur WMI.

Remarques

WEKF_CustomKey.Remove supprime un objet WEKF_CustomKey existant. Si l’objet n’existe pas, WEKF_CustomKey.Remove retourne une erreur avec la valeur 0x8007007B.

Étant donné que cette méthode est statique, vous ne pouvez pas l’appeler sur un objet instance, mais vous devez l’appeler au niveau de la classe.

Exemple

Le code suivant montre comment supprimer une touche personnalisée du filtre clavier afin qu’elle ne soit plus bloquée à l’aide des fournisseurs WMI (Windows Management Instrumentation) pour le filtre de clavier.

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