STARTUPINFOA-Struktur (processthreadsapi.h)

Gibt die Fensterstation, den Desktop, die Standardhandles und die Darstellung des Standard Fensters für einen Prozess zum Zeitpunkt der Erstellung an.

Syntax

typedef struct _STARTUPINFOA {
  DWORD  cb;
  LPSTR  lpReserved;
  LPSTR  lpDesktop;
  LPSTR  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;
} STARTUPINFOA, *LPSTARTUPINFOA;

Member

cb

Die Größe der Struktur in Bytes.

lpReserved

Reserviert; muss NULL sein.

lpDesktop

Der Name des Desktops oder der Name der Desktop- und Fensterstation für diesen Prozess. Ein umgekehrter Schrägstrich in der Zeichenfolge gibt an, dass die Zeichenfolge sowohl die Namen der Desktop- als auch der Fensterstation enthält.

Weitere Informationen finden Sie unter Threadverbindung mit einem Desktop.

lpTitle

Bei Konsolenprozessen ist dies der Titel, der in der Titelleiste angezeigt wird, wenn ein neues Konsolenfenster erstellt wird. Wenn NULL, wird stattdessen der Name der ausführbaren Datei als Fenstertitel verwendet. Dieser Parameter muss null für GUI- oder Konsolenprozesse sein, die kein neues Konsolenfenster erstellen.

dwX

Wenn dwFlags STARTF_USEPOSITION angibt, ist dieses Element der x-Offset der oberen linken Ecke eines Fensters, wenn ein neues Fenster erstellt wird, in Pixel. Andernfalls wird dieser Member ignoriert.

Der Offset befindet sich von der oberen linken Ecke des Bildschirms. Für GUI-Prozesse wird die angegebene Position verwendet, wenn der neue Prozess CreateWindow zum ersten Mal aufruft, um ein überlappende Fenster zu erstellen, wenn der x-Parameter von CreateWindow CW_USEDEFAULT ist.

dwY

Wenn dwFlags STARTF_USEPOSITION angibt, ist dieses Element der y-Offset der oberen linken Ecke eines Fensters, wenn ein neues Fenster erstellt wird, in Pixel. Andernfalls wird dieser Member ignoriert.

Der Offset befindet sich von der oberen linken Ecke des Bildschirms. Für GUI-Prozesse wird die angegebene Position verwendet, wenn der neue Prozess CreateWindow zum ersten Mal aufruft, um ein überlappende Fenster zu erstellen, wenn der y-Parameter von CreateWindow CW_USEDEFAULT ist.

dwXSize

Wenn dwFlags STARTF_USESIZE angibt, ist dieses Element die Breite des Fensters, wenn ein neues Fenster erstellt wird( in Pixeln). Andernfalls wird dieser Member ignoriert.

Für GUI-Prozesse wird dies nur verwendet, wenn der neue Prozess CreateWindow zum ersten Mal aufruft, um ein überlappende Fenster zu erstellen, wenn der nWidth-Parameter von CreateWindow CW_USEDEFAULT ist.

dwYSize

Wenn dwFlags STARTF_USESIZE angibt, ist dieses Element die Höhe des Fensters, wenn ein neues Fenster in Pixel erstellt wird. Andernfalls wird dieser Member ignoriert.

Für GUI-Prozesse wird dies nur verwendet, wenn der neue Prozess CreateWindow zum ersten Mal aufruft, um ein überlappende Fenster zu erstellen, wenn der nHeight-Parameter von CreateWindow CW_USEDEFAULT ist.

dwXCountChars

Wenn dwFlags STARTF_USECOUNTCHARS angibt und ein neues Konsolenfenster in einem Konsolenprozess erstellt wird, gibt dieses Element die Bildschirmpufferbreite in Zeichenspalten an. Andernfalls wird dieser Member ignoriert.

dwYCountChars

Wenn dwFlags STARTF_USECOUNTCHARS angibt und ein neues Konsolenfenster in einem Konsolenprozess erstellt wird, gibt dieses Element die Höhe des Bildschirmpuffers in Zeichenzeilen an. Andernfalls wird dieser Member ignoriert.

dwFillAttribute

Wenn dwFlags STARTF_USEFILLATTRIBUTE angibt, ist dieses Element die Anfangstext- und Hintergrundfarben, wenn in einer Konsolenanwendung ein neues Konsolenfenster erstellt wird. Andernfalls wird dieser Member ignoriert.

Dieser Wert kann eine beliebige Kombination der folgenden Werte sein: FOREGROUND_BLUE, FOREGROUND_GREEN, FOREGROUND_RED, FOREGROUND_INTENSITY, BACKGROUND_BLUE, BACKGROUND_GREEN, BACKGROUND_RED und BACKGROUND_INTENSITY. Die folgende Kombination von Werten erzeugt beispielsweise roten Text auf weißem Hintergrund:

FOREGROUND_RED| BACKGROUND_RED| BACKGROUND_GREEN| BACKGROUND_BLUE

dwFlags

Ein Bitfeld, das bestimmt, ob bestimmte STARTUPINFO-Member verwendet werden, wenn der Prozess ein Fenster erstellt. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

wShowWindow

Wenn dwFlags STARTF_USESHOWWINDOW angibt, kann es sich bei diesem Member um einen der Werte handeln, die im nCmdShow-Parameter für die ShowWindow-Funktion angegeben werden können, mit Ausnahme von SW_SHOWDEFAULT. Andernfalls wird dieser Member ignoriert.

Bei GUI-Prozessen wird der nCmdShow-Parameter ignoriert, wenn ShowWindow zum ersten Mal aufgerufen wird. wShowWindow gibt den Standardwert an. Bei nachfolgenden Aufrufen von ShowWindow wird das wShowWindow-Element verwendet, wenn der nCmdShow-Parameter von ShowWindow auf SW_SHOWDEFAULT festgelegt ist.

cbReserved2

Reserviert für die Verwendung durch die C-Laufzeit; muss null sein.

lpReserved2

Reserviert für die Verwendung durch die C-Laufzeit; muss NULL sein.

hStdInput

Wenn dwFlags STARTF_USESTDHANDLES angibt, ist dieses Element das Standardeingabehandle für den Prozess. Wenn STARTF_USESTDHANDLES nicht angegeben ist, ist der Standard für die Standardeingabe der Tastaturpuffer.

Wenn dwFlags STARTF_USEHOTKEY angibt, gibt dieses Element einen Hotkeywert an, der als wParam-Parameter einer WM_SETHOTKEY Nachricht an das erste berechtigte Fenster der obersten Ebene gesendet wird, das von der Anwendung erstellt wurde, die den Prozess besitzt. Wenn das Fenster mit der WS_POPUP Fensterformatvorlage erstellt wird, ist es nicht berechtigt, es sei denn, die WS_EX_APPWINDOW erweiterten Fensterstil wird ebenfalls festgelegt. Weitere Informationen finden Sie unter CreateWindowEx.

Andernfalls wird dieser Member ignoriert.

hStdOutput

Wenn dwFlags STARTF_USESTDHANDLES angibt, ist dieses Element das Standardausgabehandle für den Prozess. Andernfalls wird dieser Member ignoriert, und der Standard für die Standardausgabe ist der Puffer des Konsolenfensters.

Wenn ein Prozess über die Taskleiste oder Sprungliste gestartet wird, legt das System hStdOutput auf ein Handle für den Monitor fest, der die Taskleiste oder Sprungliste enthält, die zum Starten des Prozesses verwendet wird. Weitere Informationen finden Sie unter Hinweise. Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP und Windows Server 2003: Dieses Verhalten wurde in Windows 8 und Windows Server 2012 eingeführt.

hStdError

Wenn dwFlags STARTF_USESTDHANDLES angibt, ist dieses Element das Standardfehlerhandle für den Prozess. Andernfalls wird dieser Member ignoriert, und der Standardfehler ist der Puffer des Konsolenfensters.

Hinweise

Bei Grafischen Benutzeroberflächenprozessen (GUI) wirken sich diese Informationen auf das erste Fenster aus, das von der CreateWindow-Funktion erstellt und von der ShowWindow-Funktion angezeigt wird. Bei Konsolenprozessen wirken sich diese Informationen auf das Konsolenfenster aus, wenn eine neue Konsole für den Prozess erstellt wird. Ein Prozess kann die GetStartupInfo-Funktion verwenden, um die STARTUPINFO-Struktur abzurufen, die beim Erstellen des Prozesses angegeben wurde.

Wenn ein GUI-Prozess gestartet wird und weder STARTF_FORCEONFEEDBACK noch STARTF_FORCEOFFFEEDBACK angegeben ist, wird der Prozessfeedbackcursor verwendet. Ein GUI-Prozess ist ein Prozess, dessen Subsystem als "Windows" angegeben wird.

Wenn ein Prozess über die Taskleiste oder Sprungliste gestartet wird, legt das System GetStartupInfo fest, um die STARTUPINFO-Struktur abzurufen und zu überprüfen, ob hStdOutput festgelegt ist. Wenn dies der Fall ist, verwenden Sie GetMonitorInfo , um zu überprüfen, ob hStdOutput ein gültiges Monitorhandle (HMONITOR) ist. Der Prozess kann dann das Handle verwenden, um seine Fenster zu positionieren.

Wenn das flag STARTF_UNTRUSTEDSOURCE angegeben ist, sollte die Anwendung beachten, dass die Befehlszeile nicht vertrauenswürdig ist. Wenn dieses Flag festgelegt ist, sollten Anwendungen potenziell gefährliche Features wie Makros, heruntergeladene Inhalte und automatisches Drucken deaktivieren. Dieses Flag ist optional, aber Anwendungen, die CreateProcess aufrufen, werden empfohlen, dieses Flag festzulegen, wenn sie ein Programm mit nicht vertrauenswürdigen Befehlszeilenargumenten (z. B. von Webinhalten bereitgestellt) starten, damit der neu erstellte Prozess die entsprechende Richtlinie anwenden kann.

Das STARTF_UNTRUSTEDSOURCE-Flag wird ab Windows Vista unterstützt, ist aber vor dem Windows 10 SDK nicht in den SDK-Headerdateien definiert. Um das Flag in Versionen vor Windows 10 zu verwenden, können Sie es manuell in Ihrem Programm definieren.

Beispiele

Im folgenden Codebeispiel wird die Verwendung von StartUpInfoA veranschaulicht.

#include <windows.h>
#include <stdio.h>
#include <tchar.h>

void _tmain( int argc, TCHAR *argv[] )
{
    STARTUPINFO si;
    PROCESS_INFORMATION pi;

    ZeroMemory( &si, sizeof(si) );
    si.cb = sizeof(si);
    ZeroMemory( &pi, sizeof(pi) );

    if( argc != 2 )
    {
        printf("Usage: %s [cmdline]\n", argv[0]);
        return;
    }

    // Start the child process. 
    if( !CreateProcess( NULL,   // No module name (use command line)
        argv[1],        // Command line
        NULL,           // Process handle not inheritable
        NULL,           // Thread handle not inheritable
        FALSE,          // Set handle inheritance to FALSE
        0,              // No creation flags
        NULL,           // Use parent's environment block
        NULL,           // Use parent's starting directory 
        &si,            // Pointer to STARTUPINFO structure
        &pi )           // Pointer to PROCESS_INFORMATION structure
    ) 
    {
        printf( "CreateProcess failed (%d).\n", GetLastError() );
        return;
    }

    // Wait until child process exits.
    WaitForSingleObject( pi.hProcess, INFINITE );

    // Close process and thread handles. 
    CloseHandle( pi.hProcess );
    CloseHandle( pi.hThread );
}

Weitere Informationen zu diesem Beispiel finden Sie unter Erstellen von Prozessen.

Anforderungen

Weitere Informationen

CreateProcess

CreateProcessAsUser

CreateProcessWithLogonW

CreateProcessWithTokenW

GetStartupInfo