Share via


IOCTL_HAL_INITREGISTRY

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/27/2008

This IOCTL is used by Filesys.exe to signal that the registry is active and that data from the OAL can now be propagated to the registry. It is called before other applications are started, so the OAL can modify registry settings used by all applications.

The OEMIoControl function calls this IOCTL.

Parameters

  • dwIoControlCode
    [in] Set to IOCTL_HAL_INITREGISTRY.
  • lpInBuf
    [in] Set to NULL.
  • nInBufSize
    [in] Set to 0.
  • lpOutBuf
    [in] Set to NULL.
  • nOutBufSize
    [in] Set to 0.
  • lpBytesReturned
    [in] Set to NULL.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

When this IOCTL is called from Filesys.exe the registry is fully enabled and ready to accept data from the OAL. The following APIs are OAL-only functions corresponding to the standard Windows-based desktop platforms registry APIs. Registry APIs that are not on this list do not have equivalents that are usable in the OAL.

  • NKRegCreateKeyEx
  • NKRegOpenKeyEx
  • NKRegQueryValueEx
  • NKRegCloseKey
  • NKRegSetValueEx

The registry is updated before starting an application that is registered in the HKEY_LOCAL_MACHINE\Init registry key.

Requirements

Header pkfuncs.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

OEMIoControl

Other Resources

RegCreateKeyEx
RegOpenKeyEx
RegQueryValueEx
RegCloseKey
RegSetValueEx