WSManConnectShellCommand 関数 (wsman.h)

シェルで実行されている既存のコマンドに接続します。

構文

void WSManConnectShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE   shell,
                 DWORD                flags,
  [in]           PCWSTR               commandID,
  [in, optional] WSMAN_OPTION_SET     *options,
  [in, optional] WSMAN_DATA           *connectXml,
  [in]           WSMAN_SHELL_ASYNC    *async,
  [out]          WSMAN_COMMAND_HANDLE *command
);

パラメーター

[in, out] shell

WSManCreateShell 呼び出しによって返されるシェル ハンドルを指定します。 このパラメーターを NULL にすることはできません。

flags

将来利用するために予約されています。 ゼロを指定してください。

[in] commandID

クライアントが接続しようとしている特定のコマンド (現在サーバー セッションで実行されている) を識別する null で終わる文字列。

[in, optional] options

コマンドの一連のオプションを定義します。 これらのオプションは、コマンドの実行を変更または調整するためにサービスに渡されます。 このパラメーターは、NULL でもかまいません。 オプションの詳細については、「 WSMAN_OPTION_SET」を参照してください。

[in, optional] connectXml

接続シェル操作のオープン コンテキストを定義する WSMAN_DATA 構造体へのポインター。 コンテンツは有効な XML 文字列である必要があります。 このパラメーターは、NULL でもかまいません。

[in] async

省略可能なユーザー コンテキストと必須のコールバック関数を含む非同期構造体を定義します。 詳細については、「 WSMAN_SHELL_ASYNC」を参照してください。 このパラメーターを NULL にすることはできません。

[out] command

このハンドルは正常な呼び出しで返され、データの送受信とコマンドの通知に使用されます。 このハンドルの使用が完了したら、 WSManCloseCommand メソッドを呼び出して閉じます。 このパラメーターを NULL にすることはできません。

戻り値

なし

必要条件

要件	値
サポートされている最小のクライアント	Windows 8
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	Windows
ヘッダー	wsman.h
Library	WsmSvc.lib
[DLL]	WsmSvc.dll