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 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), IrqlRtlPassive(wdm)