次の方法で共有

WSMAN_SHELL_STARTUP_INFO_V10 構造体 (wsman.h)

  • [アーティクル]

WSManCreateShell 関数で使用するシェル スタートアップ パラメーターを定義します。 構造体はクライアントによって割り当てられ、 WSManCreateShell 関数に渡される必要があります。

WSManCreateShell 関数に渡される構成は、シェル内で実行されるコマンドの動作に直接影響する可能性があります。 一般的な例として、各プロセスに関連付けられている作業ディレクトリを記述する workingDirectory 引数があります。この引数は、オペレーティング システムが相対パスを使用して指定されたファイルを検索するときに使用します。

ストリームの名前付けに固有の要件がない場合、クライアントとサービスは、入力ストリームに STDIN 、既定の出力ストリームに STDOUT 、エラーまたは状態の出力ストリームに STDERR を使用する必要があります。

構文

typedef struct _WSMAN_SHELL_STARTUP_INFO_V10 {
  WSMAN_STREAM_ID_SET            *inputStreamSet;
  WSMAN_STREAM_ID_SET            *outputStreamSet;
  DWORD                          idleTimeoutMs;
  PCWSTR                         workingDirectory;
  WSMAN_ENVIRONMENT_VARIABLE_SET *variableSet;
} WSMAN_SHELL_STARTUP_INFO_V10;

メンバー

inputStreamSet

シェルの入力ストリームのセットを指定する WSMAN_STREAM_ID_SET 構造体へのポインター。 フィルターに存在しないストリームは、シェル実装では無視できます。 Windows Cmd.exe シェルの場合、この値は L"stdin" である必要があります。 値が NULL の場合、実装では L"stdin" の配列が既定値として使用されます。

outputStreamSet

シェルの出力ストリームのセットを指定する WSMAN_STREAM_ID_SET 構造体へのポインター。 フィルターに存在しないストリームは、シェル実装では無視できます。 Windows cmd.exe シェルの場合、この値は L"stdout stderr" である必要があります。 値が NULL の場合、実装では L"stdout" と L"stderr" を持つ配列が既定値として使用されます。

idleTimeoutMs

シェルがクライアント要求なしで開いたままになる最大期間をミリ秒単位で指定します。 最大期間を超えると、シェルは自動的に削除されます。 0 から0xFFFFFFFFまでの任意の値を設定できます。 この期間の最大値は、アイドルタイムアウト GPO 設定 (有効な場合) または IdleTimeout ローカル構成によって指定されます。 GPO/ローカル構成の最大期間の既定値は 15 分です。 ただし、システム管理者はこの値を変更できます。 GPO/ローカル構成の最大値を使用するには、クライアントはこのフィールドに 0 (ゼロ) を指定する必要があります。 0 ~ 0xFFFFFFFFの明示的な値を使用する場合は、明示的な API 値と GPO/ローカル構成の値の間の最小値が使用されます。

workingDirectory

シェルの開始ディレクトリを指定します。 これは、任意の実行コマンドで使用されます。 このメンバーが NULL 値の場合、コマンドの実行時にリモート コンピューターによって既定のディレクトリが使用されます。 空の値は、基になるプロトコルによって省略された値として扱われます。

variableSet

シェル の開始 環境を記述する変数名と値のペアの配列を指定するWSMAN_ENVIRONMENT_VARIABLE_SET構造体へのポインター。 これらの要素の内容はシェル固有であり、他の環境変数の観点から定義できます。 NULL 値が渡された場合は、サーバー側で既定の環境が使用されます。

要件

要件 値
サポートされている最小のクライアント Windows 7
サポートされている最小のサーバー Windows Server 2008 R2
Header wsman.h
再頒布可能パッケージ WINDOWS Server 2008 SP2、Windows Vista sp1、Windows Vista sp2 でのWindows Management Framework