WEKF_CustomKey.Remove

Entfernt eine benutzerdefinierte Tastenkombination, wodurch der Tastaturfilter die Sperrung der entfernten Tastenkombination beenden kann.

Syntax

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

Parameter

CustomKey [in] Die benutzerdefinierte Tastenkombination, die entfernt werden soll.

Rückgabewert

Gibt einen HRESULT-Wert zurück, der den WMI-Status oder einen WMI-Fehler angibt.

Hinweise

WEKF_CustomKey.Remove entfernt ein vorhandenes WEKF_CustomKey-Objekt . Wenn das Objekt nicht vorhanden ist, gibt WEKF_CustomKey.Remove einen Fehler mit dem Wert 0x8007007B zurück.

Da diese Methode statisch ist, können Sie sie nicht in einer Objektinstanz aufrufen, müssen sie stattdessen auf Klassenebene aufrufen.

Beispiel

Im folgenden Code wird veranschaulicht, wie Sie eine benutzerdefinierte Taste aus dem Tastaturfilter entfernen, sodass sie nicht mehr mithilfe der Windows Verwaltungsinstrumentation (WMI)-Anbieter für Tastaturfilter blockiert wird.

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

Anforderungen

Windows-Edition Unterstützt
Windows 10 Home Nein
Windows 10 Pro Nein
Windows 10 Enterprise Yes
Windows 10 Education Yes

WEKF_CustomKey

Tastaturfilter