共用方式為


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 檔中。

備註

此函式沒有相關聯的頭檔。 您也可以使用 LoadLibraryGetProcAddress 函式,動態連結至 Ntdll.dll。

規格需求

   
目標平台 Windows
標頭 winternl.h
程式庫 ntdll.lib
Dll ntdll.dll

另請參閱

登錄機碼安全性和訪問許可權