RegistrySetDWORD

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

This function sets a REG_DWORD registry value.


HRESULT WINAPI RegistrySetDWORD( 
  HKEY hKey,
  LPCTSTR pszSubKey,
  LPCTSTR pszValueName,
  DWORD dwData 
);

hKey

[in] Handle to the open key or a predefined root value.

pszSubKey

[in] Key where the value is stored. If this value is NULL, then pszValueName is assumed to be under hkey.

pszValueName

[in] Named value to set. If this value is NULL, the function sets the default value.

dwData

[in] New value.

The following table shows the return values for this function.

Value Description

S_OK

Value in pszValueName is replaced by the value in dwData.

E_INVALIDARG

Invalid hkey.

E_DATATYPE_MISMATCH

The value is not type REG_DWORD.

An error value returned by RegOpenKey or RegQueryValueEx.

Error value wrapped as a FACILITY_WIN32 HRESULT.

Success indicates that the old value is replaced by the new value. Failure does cause any change.

If the key pointed to by hkey and pszSubkey does not exist, the function fails.

If the client might be calling RegistrySetDWORD multiple times, it should cache a handle to the key using RegOpenKeyEx and pass the handle instead of passing a string value. Every time RegistrySetDWORD is called with a string value for the key, the RegOpenKeyEx and RegCloseKey functions are called, so passing a handle instead of a string value can avert a potential performance problem over mutltiple calls.

Headerregext.h
Libraryaygshell.lib
Windows Embedded CEWindows Embedded CE 6.0 and later
Windows MobilePocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later
Show: