NtQueryMultipleValueKey 関数 (winternl.h)

[この関数は、それ以上の通知なしに Windows から変更または削除される場合があります。]

指定した複数値キーの値を取得します。

構文

__kernel_entry NTSTATUS NtQueryMultipleValueKey(
  [in]            HANDLE           KeyHandle,
  [in, out]       PKEY_VALUE_ENTRY ValueEntries,
  [in]            ULONG            EntryCount,
  [out]           PVOID            ValueBuffer,
  [in, out]       PULONG           BufferLength,
  [out, optional] PULONG           RequiredBufferLength
);

パラメーター

[in] KeyHandle

値を取得するキーへのハンドル。 KEY_QUERY_VALUE アクセス権 を使用してハンドルを開く必要があります。

[in, out] ValueEntries

取得する値の名前を含む [KEY_VALUE_ENTRY] 構造体の配列へのポインター。

[in] EntryCount

ValueEntries 配列内の要素の数。

[out] ValueBuffer

値を受け取るバッファーへのポインター。

[in, out] BufferLength

ValueBuffer にあるバッファーのサイズをバイト単位で格納する変数へのポインター。 関数が戻るとき、 BufferLength パラメーターには 、ValueBuffer でバッファーに書き込まれたバイト数が含まれます。

[out, optional] RequiredBufferLength

関数によって返されるすべての値に必要なバイト数を受け取る変数へのポインター。 このパラメーターは、NULL でもかまいません。

戻り値

NTSTATUS またはエラー コードを返します。

バッファーが小さすぎて取得する情報を保持できない場合、関数は STATUS_BUFFER_OVERFLOW を返し、 RequiredBufferLength パラメーターが指定されている場合は、必要なバッファー サイズに設定します。

NTSTATUS エラー コードの形式と重要性は、WDK で使用できる Ntstatus.h ヘッダー ファイルに記載されており、WDK ドキュメントで説明されています。

注釈

この関数には、ヘッダー ファイルが関連付けされません。 LoadLibrary 関数と GetProcAddress 関数を使用して、Ntdll.dll に動的にリンクすることもできます。

要件

対象プラットフォーム	Windows
ヘッダー	winternl.h
Library	ntdll.lib
[DLL]	ntdll.dll

こちらもご覧ください

レジストリ キーのセキュリティとアクセス権