SignalStarted (Compact 2013)

3/28/2014

This function signals that an application has started and initialization is complete.

Syntax

VOID SignalStarted(
  DWORD dw
);

Parameters

  • dw
    [in] Specifies the sequence in which the application is started by the system.

Return Value

None.

Remarks

This function must be called by all applications that the kernel starts at startup through the HKEY_LOCAL_MACHINE\Init registry key. The system passes the application its sequence identifier character string on the command line of the WinMain entry point.

Note

The command line cannot be used to pass any information other than the sequence identifier. If an application must have information passed to it during boot, it can read the information from the registry or from a configuration file.

When the application has finished initialization, it converts the string to a DWORD and passes it to SignalStarted. If SignalStarted is not called by such an application, other applications that are dependent on its launch will never run. If SignalStarted is called but the application does not run at startup, system operation will not be affected.

Requirements

Header

winbase.h

Library

coredll.lib

See Also

Reference

System Management Functions