RtlDeleteRegistryValue 関数 (wdm.h)
RtlDeleteRegistryValue ルーチンは、指定された相対パスに沿って、指定されたエントリ名と関連付けられた値をレジストリから削除します。
構文
NTSYSAPI NTSTATUS RtlDeleteRegistryValue(
[in] ULONG RelativeTo,
[in] PCWSTR Path,
[in] PCWSTR ValueName
);
パラメーター
[in] RelativeTo
Path が絶対レジストリ パスであるか、定義済みのキー パスに対する相対パスであるかを次のように指定します。
| 値 | 意味 |
|---|---|
| RTL_REGISTRY_ABSOLUTE | パスは絶対レジストリ パスです。 |
| 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\ です。既定値)。) |
| 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 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), IrqlRtlPassive(wdm) |