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 |