共用方式為

WEKF_CustomKey.Add

  • 發行項
  • 適用於:
    ✅ Windows 11, ✅ Windows 10

建立新的自定義按鍵組合，並讓鍵盤篩選器封鎖新的按鍵組合。

語法

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

參數

CustomKey
[in] 要新增的自定義按鍵組合。 如需有效按鍵名稱的清單，請參閱 鍵盤篩選按鍵名稱。

傳回值

傳回 HRESULT 值，指出 WMI 非錯誤常數 或 WMI 錯誤常數。

備註

WEKF_CustomKey.Add 會建立新的 WEKF_CustomKey 物件，並將新物件的 Enabled 屬性設定為 true，並將 Id 屬性設定為 CustomKey。

如果 id 屬性等於 CustomKey 的WEKF_CustomKey對象已經存在，則 WEKF_CustomKey.Add 會傳回錯誤碼，而且不會建立新的物件或修改現有物件的任何屬性。 如果現有的WEKF_CustomKey物件將 Enabled 屬性設定為 false，鍵盤篩選不會封鎖自定義按鍵組合。

範例

下列程式代碼示範如何使用鍵盤篩選的 Windows Management Instrumentation （WMI） 提供者，新增或啟用鍵盤篩選會封鎖的自定義按鍵。

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

需求

Windows 版本 支援
Windows Home No
Windows 專業版 No
Windows 企業版 Yes
Windows 教育版 Yes
Windows IoT 企業版 Yes