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 |
程式庫 | ntdll.lib |
Dll | ntdll.dll |