Criar processos

A função CreateProcess cria um novo processo que é executado independentemente do processo de criação. Para simplificar, essa relação é chamada de relação pai-filho.

Importante

Segurança — herança de identificadores: Defina bInheritHandles como FALSE, a menos que o processo filho precise especificamente de acesso a identificadores herdados. Identificadores herdados (identificadores de arquivo, soquetes, tokens) podem vazar recursos confidenciais para processos filho. Quando a herança for necessária, use STARTUPINFOEXUpdateProcThreadAttribute(PROC_THREAD_ATTRIBUTE_HANDLE_LIST, ...) para listar explicitamente apenas os identificadores que o filho precisa.

Importante

LpCommandLine deve ser gravável: ao passar uma linha de comando como o parâmetro lpCommandLine (segundo parâmetro), o buffer deve ser uma matriz de caracteres gravável , não um literal de cadeia de caracteres ou const ponteiro. A versão Unicode (CreateProcessW) pode modificar esse buffer em vigor. Passar uma string somente de leitura causa uma violação de acesso.

Note

Alternativas modernas: para cenários de criação de processo mais simples, considere System.Diagnostics.Process (.NET), (CRT) _wspawnl/_wsystem ou ShellExecuteEx (para iniciar documentos/URLs com manipulação de verbo). Use CreateProcess quando precisar de controle total sobre herança de identificador, atributos de processo, descritores de segurança ou sinalizadores de criação.

O código a seguir demonstra como criar um processo.

#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 );
}

Se CreateProcess for bem-sucedido, ele retorna uma estrutura PROCESS_INFORMATION que contém handles e identificadores para o novo processo e sua thread primária. Os handles de thread e de processo são criados com direitos de acesso total, embora você possa restringir o acesso se especificar descritores de segurança. Quando você não precisar mais desses identificadores, feche-os usando a função CloseHandle.

Você também pode criar um processo usando as funções CreateProcessAsUser ou CreateProcessWithLogonW. Essas funções permitem especificar o contexto de segurança da conta de usuário na qual o processo é executado.