Función WslLaunch (wslapi.h)

Inicia un proceso de Subsistema de Windows para Linux (WSL) en el contexto de una distribución determinada.

Sintaxis

HRESULT WslLaunch(
  [in]           PCWSTR distributionName,
  [in, optional] PCWSTR command,
  [in]           BOOL   useCurrentWorkingDirectory,
  [in]           HANDLE stdIn,
  [in]           HANDLE stdOut,
  [in]           HANDLE stdErr,
  [out]          HANDLE *process
);

Parámetros

[in] distributionName

Nombre único que representa una distribución (por ejemplo, "Fabrikam.Distro.10.01").

[in, optional] command

Comando que se ejecuta. Si no se proporciona ningún comando, inicia el shell predeterminado.

[in] useCurrentWorkingDirectory

Controla si el proceso iniciado debe heredar o no el directorio de trabajo del proceso de llamada. Si es FALSE, el proceso se inicia en el directorio principal del usuario predeterminado de WSL ("~").

[in] stdIn

Identificador que se va a usar para STDIN.

[in] stdOut

Identificador que se va a usar para STDOUT.

[in] stdErr

Identificador que se va a usar para STDERR.

[out] process

Puntero a dirección para recibir el controlador de proceso asociado al proceso de WSL recién iniciado.

Valor devuelto

Devuelve S_OK si se ha realizado correctamente o un VALOR HRESULT con errores.

Comentarios

El autor de la llamada es responsable de llamar a CloseHandle en el valor devuelto en phProcess si se realiza correctamente.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	wslapi.h
Library	Wslapi.lib
Archivo DLL	Api-ms-win-wsl-api-l1-1-0.dll