ZwDeleteValueKey 関数 (wdm.h)

[アーティクル]
03/08/2023

ZwDeleteValueKey ルーチンは、レジストリ内の開いているキーから名前と一致する値エントリを削除します。そのようなエントリが存在しない場合は、エラーが返されます。

構文

NTSYSAPI NTSTATUS ZwDeleteValueKey(
  [in] HANDLE          KeyHandle,
  [in] PUNICODE_STRING ValueName
);

パラメーター

[in] KeyHandle

目的の値エントリを含むレジストリキーへのハンドル。このキーは、目的のアクセスKEY_SET_VALUE設定して開かれている必要があります。このハンドルは、 ZwCreateKey または ZwOpenKey の正常な呼び出しによって作成されます。

[in] ValueName

削除する値エントリの名前を含むUNICODE_STRING構造体へのポインター。値エントリに名前がない場合、このパラメーターは空の文字列にすることができます。

戻り値

ZwDeleteValueKey は 、操作の最終的な完了状態を表すSTATUS_SUCCESSまたは適切なエラー状態を返します。考えられるエラー状態コードは次のとおりです。

リターンコード	説明
STATUS_ACCESS_DENIED	KeyHandle ハンドルには、KEY_SET_VALUEアクセス権がありません。
STATUS_INSUFFICIENT_RESOURCES	この関数に必要な追加のリソースは使用できませんでした。
STATUS_INVALID_HANDLE	指定された KeyHandle パラメーターが NULL ポインターであるか、開いているレジストリキーへの有効なポインターではありません。
STATUS_OBJECT_NAME_NOT_FOUND	ValueName レジストリキーエントリが見つかりませんでした。

注釈

削除アクセスを成功させるには、ZwDeleteValueKey に渡される KeyHandle が開かれている必要があります。 KEY_SET_VALUE、KEY_WRITE、および KEY_ALL_ACCESS の DesiredAccess 値には、削除アクセスに必要なKEY_SET_VALUE アクセスマスクが含まれます。 DesiredAccess で使用できる値の説明については、「ZwCreateKey」を参照してください。

このレジストリキーにコールバック関数が登録されている場合、これらのコールバック関数が呼び出されます。

デバイスドライバーは、\Registry のサブキー内の値エントリを削除するために 、ZwDeleteValueKey を直接呼び出そうとしないでください 。\ResourceMap キー。 \Registry の値エントリを書き込んだり削除したりできるのは、システムだけです 。\HardwareDescription ツリー。

この関数の呼び出しがユーザーモードで行われる場合は、"ZwDeleteValueKey" ではなく"NtDeleteValueKey" という名前を使用する必要があります。

カーネルモードドライバーからの呼び出しの場合、Windows ネイティブシステムサービスルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx バージョンと ZwXxx バージョンの間の関係の詳細については、「ネイティブシステムサービスルーチンの Nt バージョンと Zw バージョンの使用」を参照してください。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h、Fltkernel.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)