The STARTUPINFO structure is used with the CreateProcess function to specify main window properties if a new window is created for the new process. For graphical user interface (GUI) processes, this information affects the first window created by the CreateWindow function and shown by the ShowWindow function. For console processes, this information affects the console window if a new console is created for the process. A process can use the GetStartupInfo function to retrieve the STARTUPINFO structure specified when the process was created.
typedef struct _STARTUPINFO { // si DWORD cb; LPTSTR lpReserved; LPTSTR lpDesktop; LPTSTR lpTitle; DWORD dwX; DWORD dwY; DWORD dwXSize; DWORD dwYSize; DWORD dwXCountChars; DWORD dwYCountChars; DWORD dwFillAttribute; DWORD dwFlags; WORD wShowWindow; WORD cbReserved2; LPBYTE lpReserved2; HANDLE hStdInput; HANDLE hStdOutput; HANDLE hStdError; } STARTUPINFO, *LPSTARTUPINFO;
FOREGROUND_RED | BACKGROUND_RED | BACKGROUND_GREEN | BACKGROUND_BLUE
Value |
Meaning |
STARTF_USESHOWWINDOW |
If this value is not specified, the wShowWindow member is ignored. |
STARTF_USEPOSITION |
If this value is not specified, the dwX and dwY members are ignored. |
STARTF_USESIZE |
If this value is not specified, the dwXSize and dwYSize members are ignored. |
STARTF_USECOUNTCHARS |
If this value is not specified, the dwXCountChars and dwYCountChars members are ignored. |
STARTF_USEFILLATTRIBUTE |
If this value is not specified, the dwFillAttribute member is ignored. |
STARTF_FORCEONFEEDBACK |
If this value is specified, the cursor is in feedback mode for two seconds after CreateProcess is called. If during those two seconds the process makes the first GUI call, the system gives five more seconds to the process. If during those five seconds the process shows a window, the system gives five more seconds to the process to finish drawing the window. |
The system turns the feedback cursor off after the first call to GetMessage, regardless of whether the process is drawing. | |
For more information on feedback, see the following Remarks section. | |
STARTF_FORCEOFFFEEDBACK |
If specified, the feedback cursor is forced off while the process is starting. The normal cursor is displayed. For more information on feedback, see the following Remarks section. |
STARTF_USESTDHANDLES |
If this value is specified, sets the standard input of the process, standard output, and standard error handles to the handles specified in the hStdInput, hStdOutput, and hStdError members of the STARTUPINFO structure. The CreateProcess function’s fInheritHandles parameter must be set to TRUE for this to work properly. |
If this value is not specified, the hStdInput, hStdOutput, and hStdError members of the STARTUPINFO structure are ignored. |
If a GUI process is being started and neither STARTF_FORCEONFEEDBACK or STARTF_FORCEOFFFEEDBACK is specified, the process feedback cursor is used. A GUI process is one whose subsystem is specified as “windows.”
CreateProcess, CreateProcessAsUser, CreateWindow, GetMessage, GetStartupInfo, PeekMessage, ShowWindow, WinMain
file: /Techref/os/win/api/win32/struc/src/str20_32.htm, 11KB, , updated: 2000/4/7 11:20, local time: 2024/12/4 01:32,
18.97.9.171:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://techref.massmind.org/techref/os/win/api/win32/struc/src/str20_32.htm"> STARTUPINFO</A> |
Did you find what you needed? |
Welcome to massmind.org! |
Welcome to techref.massmind.org! |
.