WEKF _ customkey。削除WEKF_CustomKey.Remove

カスタムキーの組み合わせを削除します。これにより、キーボードフィルターが削除されたキーの組み合わせのブロックを停止します。Removes a custom key combination, causing Keyboard Filter to stop blocking the removed key combination.

構文Syntax

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

パラメーターParameters

Customkey []カスタムキーの組み合わせで、を削除します。CustomKey [in] The custom key combination to remove.

戻り値Return Value

Wmi の状態またはwmi エラーを示す HRESULT 値を返します。Returns an HRESULT value that indicates WMI status or a WMI error.

解説Remarks

Wekf _CustomKey。削除 すると、既存の Wekf _ customkey オブジェクトが削除されます。WEKF_CustomKey.Remove removes an existing WEKF_CustomKey object. オブジェクトが存在しない場合は、 Wekf _ Customkey. Remove は、0x8007007B 値でエラーを返します。If the object does not exist, WEKF_CustomKey.Remove returns an error with the value 0x8007007B.

このメソッドは静的であるため、オブジェクトインスタンスで呼び出すことはできませんが、代わりにクラスレベルで呼び出す必要があります。Because this method is static, you cannot call it on an object instance, but must instead call it at the class level.

Example

次のコードは、キーボードフィルターからカスタムキーを削除して、キーボードフィルターの Windows Management Instrumentation (WMI) プロバイダーを使用してブロックされないようにする方法を示しています。The following code demonstrates how to remove a custom key from Keyboard Filter so it is no longer blocked by using the Windows Management Instrumentation (WMI) providers for Keyboard Filter.

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

必要条件Requirements

Windows エディションWindows Edition サポートされていますSupported
Windows 10 HomeWindows 10 Home いいえNo
Windows 10 ProWindows 10 Pro いいえNo
Windows 10 EnterpriseWindows 10 Enterprise はいYes
Windows 10 EducationWindows 10 Education はいYes

WEKF _ customkeyWEKF_CustomKey

キーボード フィルターKeyboard Filter