WEKF_CustomKey.Remove

  • Artikel

Entfernt eine benutzerdefinierte Tastenkombination, wodurch der Tastaturfilter das Blockieren der entfernten Tastenkombination beendet.

Syntax

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

Parameter

CustomKey
[in] Die zu entfernende benutzerdefinierte Tastenkombination.

Rückgabewert

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

Bemerkungen

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

Der folgende Code veranschaulicht, wie Sie eine benutzerdefinierte Taste aus dem Tastaturfilter entfernen, sodass sie nicht mehr durch die 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 Home Nein
Windows Pro Nein
Windows Enterprise Ja
Windows Education Ja
Windows IoT Enterprise Ja