SHRegGetBoolUSValueA 函式 (shlwapi.h)

  • 發行項

從使用者特定子樹狀目錄中的登錄子機碼擷取布爾值， (HKEY_CURRENT_USER 或HKEY_LOCAL_MACHINE) 。

語法

BOOL SHRegGetBoolUSValueA(
  [in]           LPCSTR pszSubKey,
  [in, optional] LPCSTR pszValue,
  [in]           BOOL   fIgnoreHKCU,
  [in]           BOOL   fDefault
);

參數

[in] pszSubKey

類型： LPCTSTR

以 null 結尾字串的指標，其子機碼的名稱相對於 HKEY_LOCAL_MACHINE 和 HKEY_CURRENT_USER。 例如，“Software\MyCompany\MyProduct”。

[in, optional] pszValue

類型： LPCTSTR

指定值名稱之 Null 終止字串的指標。 此值可以是 NULL。

[in] fIgnoreHKCU

類型： BOOL

變數，指定要查看的索引鍵。 當設定為 TRUE 時， SHRegGetUSValue 會忽略 HKEY_CURRENT_USER ，並從 HKEY_LOCAL_MACHINE傳回值。

[in] fDefault

類型： BOOL

如果沒有登錄值，則會傳回的值。

傳回值

類型： BOOL

從登錄傳回值，如果沒有找到任何值，則傳回 fDefault 。

備註

注意

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shlwapi.dll (4.71 版或更新版本)