This topic has not yet been rated - Rate this topic

SHRegGetBoolUSValue function

Applies to: desktop apps only

Retrieves a Boolean value from a registry subkey in a user-specific subtree (HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE).

Syntax

BOOL SHRegGetBoolUSValue(
  __in      LPCTSTR pszSubKey,
  __in_opt  LPCTSTR pszValue,
  __in      BOOL fIgnoreHKCU,
  __in      BOOL fDefault
);

Parameters

pszSubKey [in]

Type: LPCTSTR

A pointer to a null-terminated string with the name of the subkey relative to HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER. For example, "Software\MyCompany\MyProduct".

pszValue [in, optional]

Type: LPCTSTR

A pointer to a null-terminated string that specifies the name of the value. This value can be NULL.

fIgnoreHKCU [in]

Type: BOOL

A variable that specifies which key to look under. When set to TRUE, SHRegGetUSValue ignores HKEY_CURRENT_USER and returns a value from HKEY_LOCAL_MACHINE.

fDefault [in]

Type: BOOL

A value that is returned if there is no registry value.

Return value

Type: BOOL

Returns either the value from the registry, or fDefault if none is found.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP

Minimum supported server

Windows 2000 Server

Header

Shlwapi.h

Library

Shlwapi.lib

DLL

Shlwapi.dll (version 4.71 or later)

Unicode and ANSI names

SHRegGetBoolUSValueW (Unicode) and SHRegGetBoolUSValueA (ANSI)

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ