WslLaunch 関数 (wslapi.h)

特定のディストリビューションのコンテキストでLinux 用 Windows サブシステム (WSL) プロセスを起動します。

構文

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

パラメーター

[in] distributionName

ディストリビューションを表す一意の名前 (例: "Fabrikam.Distro.10.01")。

[in, optional] command

実行するコマンド。 コマンドが指定されていない場合は、既定のシェルを起動します。

[in] useCurrentWorkingDirectory

起動されたプロセスが呼び出し元プロセスの作業ディレクトリを継承する必要があるかどうかを制御します。 FALSE の場合、WSL の既定のユーザーのホーム ディレクトリ ("~") でプロセスが開始されます。

[in] stdIn

STDIN に使用するハンドル。

[in] stdOut

STDOUT に使用するハンドル。

[in] stdErr

STDERR に使用するハンドル。

[out] process

新しく起動された WSL プロセスに関連付けられているプロセス HANDLE を受け取るアドレスへのポインター。

戻り値

成功した場合はS_OK、それ以外の場合は失敗した HRESULT を返します。

注釈

呼び出し元は、成功した場合に phProcess で返される値に対して CloseHandle を呼び出す必要があります。

要件

要件 値
対象プラットフォーム Windows
ヘッダー wslapi.h
Library Wslapi.lib
[DLL] Api-ms-win-wsl-api-l1-1-0.dll
  • Last updated on