Compartilhar via


sistema, _wsystem

Executa um comando.

Observação importanteImportante

Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

int system( const char *command ); int _wsystem( const wchar_t *command );

Parâmetros

  • command
    O comando ser executado.

Valor de retorno

Se command é NULL e o interpretador de comandos é localizado, retorna um valor diferente de zero.Se o interpretador de comandos não for encontrado, retornará 0 e defina errno a ENOENT.Se command não é NULL, system retorna o valor retornado por interpretador de comandos.Retorna o valor 0 somente se o interpretador de comandos retorna o valor 0.Um valor de retorno de – 1 indica um erro, e errno é definida como um dos seguintes valores:

  • E2BIG
    A lista de argumentos (que é dependente do sistema) é muito grande.

  • ENOENT
    O interpretador de comandos não pode ser encontrado.

  • ENOEXEC
    O arquivo de interpretador de comandos não pode ser executado como o formato é inválido.

  • ENOMEM
    Não está disponível memória suficiente para executar o comando; ou a memória disponível foi danificada; um bloco válido ou não existe, que indica que o processo que está fazendo a chamada não esteve atribuído corretamente.

Consulte _doserrno, errno, _sys_errlist, e _sys_nerr para obter mais informações sobre esses códigos de retorno.

Comentários

A função de system passa command ao interpretador de comandos, que executa a cadeia de caracteres como um comando do sistema operacional.system usa variáveis de ambiente de COMSPEC e de PATH para localizar o arquivo CMD.exe de interpretador de comandos.Se command é NULL, a função verifica apenas se o interpretador de comandos existe.

Você deve explicitamente resplendor- por usar fflush ou _flushall— ou para fechar qualquer fluxo antes de chamar system.

_wsystem é uma versão de largo- caractere de system; o argumento de command a _wsystem é uma cadeia de caracteres de largo- caractere.Essas funções se comportam de forma idêntica.

Mapeamentos da rotina de Genérico- texto

Rotina de TCHAR.H

_UNICODE & _MBCS não definidos

_MBCS definido

_UNICODE definido

_tsystem

system

system

_wsystem

Requisitos

Rotina

Cabeçalho necessário

system

<process.h> ou <stdlib.h>

_wsystem

<process.h> ou <stdlib.h> ou <wchar.h>

Para informações extras de compatibilidade, consulte Compatibilidade.

Exemplo

Este exemplo usa system PARA DIGITAR um arquivo de texto.

// crt_system.c

#include <process.h>

int main( void )
{
   system( "type crt_system.txt" );
}

Entrada: crt_system.txt

Line one.
Line two.

277bwbdz.collapse_all(pt-br,VS.110).gifSaída

Line one.
Line two.

Equivalência do .NET Framework

Consulte também

Referência

Processo e controle do ambiente

_exec, _wexec funções

sair, _exit

_flushall

_spawn, _wspawn funções