IOCTL_HAL_INITREGISTRY

  • Article

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 any other applications are started, so that the OAL may modify the 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

If the function succeeds then TRUE is returned; otherwise, FALSE is returned.

Remarks

When this IOCTL is called from Filesys.exe the registry is fully enabled and ready to accept data from the OAL.

The following list shows the APIs that are OAL-only functions corresponding exactly 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 will be updated before starting any application that is registered in the HKEY_LOCAL_MACHINE\Init registry key.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Pkfuncs.h.

See Also

OEMIoControl | RegCreateKeyEx | RegOpenKeyEx | RegQueryValueEx | RegCloseKey | RegSetValueEx

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.