(wdm.h) RtlDeleteRegistryValue 函式
RtlDeleteRegistryValue 例程會從指定相對路徑的登錄中移除指定的專案名稱和相關聯的值。
語法
NTSYSAPI NTSTATUS RtlDeleteRegistryValue(
[in] ULONG RelativeTo,
[in] PCWSTR Path,
[in] PCWSTR ValueName
);
參數
[in] RelativeTo
指定 Path 是絕對登錄路徑，還是相對於預先定義的機碼路徑，做為下列其中一項。
| 值 | 意義 |
|---|---|
| RTL_REGISTRY_ABSOLUTE | Path 是絕對登錄路徑。 |
| RTL_REGISTRY_SERVICES | 路徑相對於 \Registry\Machine\System\CurrentControlSet\Services。 |
| RTL_REGISTRY_CONTROL | 路徑相對於 \Registry\Machine\System\CurrentControlSet\Control。 |
| RTL_REGISTRY_WINDOWS_NT | 路徑相對於 \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion。 |
| RTL_REGISTRY_DEVICEMAP | 路徑相對於 \Registry\Machine\Hardware\DeviceMap。 |
| RTL_REGISTRY_USER | 路徑相對於 \Registry\User\CurrentUser。 (針對系統程式，這是 \Users\。Default.) |
| RTL_REGISTRY_HANDLE | 指定 Path 參數實際上是要使用的登錄句柄。 這是選擇性的值。 |
[in] Path
根據 RelativeTo 值指定登錄路徑。 如果已設定 RTL_REGISTRY_HANDLE，Path 就是直接使用的句柄。
[in] ValueName
要從登錄中移除之值名稱的指標。
傳回值
如果刪除值專案，RtlDeleteRegistryValue 會傳回STATUS_SUCCESS。
請注意，如果 RelativeTo 設定為 RTL_REGISTRY_HANDLE，就會發生下列情況：
- 在 Windows 98/Me 和 Windows NT 4.0 上，例程會在傳回之前關閉指定的句柄。
- 在 Windows 2000 和更新版本的 Windows 上，例程會讓句柄保持開啟。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIS (storport) 、 IrqlRtlPassive (wdm) |