共用方式為

RegQueryMultipleValuesW 函式 (winreg.h)

  • 發行項

擷取與開啟登錄機碼相關聯之值名稱清單的類型和資料。

語法

LSTATUS RegQueryMultipleValuesW(
  [in]                HKEY     hKey,
  [out]               PVALENTW val_list,
  [in]                DWORD    num_vals,
  [out, optional]     LPWSTR   lpValueBuf,
  [in, out, optional] LPDWORD  ldwTotsize
);

參數

[in] hKey

開啟登錄機碼的控制碼。 金鑰必須已以KEY_QUERY_VALUE存取權限開啟。 如需詳細資訊，請參閱 登錄機碼安全性和存取權限。

RegCreateKeyEx、RegCreateKeyTransacted、RegOpenKeyEx 或 RegOpenKeyTransacted 函式會傳回此控制碼。 它也可以是下列其中一個 預先定義的金鑰：

HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA
HKEY_USERS

[out] val_list

描述一或多個值專案之 VALENT 結構的陣列指標。 在輸入時，每個結構的 ve_valuename 成員必須包含要擷取之值名稱的指標。 如果指定的值不存在於指定的索引鍵中，函式就會失敗。

如果函式成功，陣列的每個元素都會包含指定值的資訊。

[in] num_vals

val_list陣列中的元素數目。

[out, optional] lpValueBuf

緩衝區的指標。 如果函式成功，緩衝區會接收每個值的資料。

如果 lpValueBuf 為 Null， 則 ldwTotsize 參數所指向的值必須是零，在此情況下，函式會傳回ERROR_MORE_DATA， 而 ldwTotsize 會接收緩衝區的必要大小，以位元組為單位。

[in, out, optional] ldwTotsize

變數的指標，指定 lpValueBuf 參數所指向的緩衝區大小，以位元組為單位。 如果函式成功， ldwTotsize 會收到複製到緩衝區的位元組數目。 如果函式因為緩衝區太小而失敗， ldwTotsize 會收到所需的大小，以位元組為單位。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

傳回碼 描述
ERROR_CANTREAD

RegQueryMultipleValues 無法具現化或存取動態索引鍵的提供者。
ERROR_MORE_DATA
 lpValueBuf所指向的緩衝區太小。 在此情況下， ldwTotsize 會收到所需的緩衝區大小。
ERROR_TRANSFER_TOO_LONG
 val_list 陣列 +ldwTotSize) 的要求 (資料大小總計超過一 MB 的系統限制。

備註

RegQueryMultipleValues函式可讓應用程式查詢靜態或動態索引鍵的一或多個值。 如果目標索引鍵是靜態索引鍵，則系統會以不可部分完成的方式提供所有值。 若要防止過度序列化，函式傳回的匯總資料不能超過一 MB。

如果目標索引鍵是動態索引鍵，則其提供者必須以不可部分完成的方式提供所有值。 這表示提供者應該同步填入結果緩衝區，同時提供緩衝區中所有值的一致檢視，同時避免過度序列化。 提供者最多可以在此函式的不可部分完成呼叫期間提供一 MB 的總輸出資料。

遠端支援 RegQueryMultipleValues ;也就是說，傳遞至函式 的 hKey 參數可以參考遠端電腦。

注意

winreg.h 標頭會根據 UNICODE 預處理器常數的定義，將 RegQueryMultipleValues 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winreg.h (包括 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

登錄函式

登錄概觀

價