SignalStarted
A version of this page is also available for
4/8/2010
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 |
| Windows Embedded CE | Windows CE 2.10 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |