WSManConnectShellCommand 函数 (wsman.h)

连接到在 shell 中运行的现有命令。

语法

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 调用返回的 shell 句柄。 此参数不能为 NULL。

flags

保留供将来使用。 必须为零。

[in] commandID

以 null 结尾的字符串，标识客户端要连接到的服务器会话中当前运行的特定命令。

[in, optional] options

定义命令的一组选项。 这些选项将传递给服务以修改或优化命令执行。 此参数可以为 NULL。 有关选项的详细信息，请参阅 WSMAN_OPTION_SET。

[in, optional] connectXml

指向 WSMAN_DATA 结构的指针，该结构定义连接 shell 操作的开放上下文。 内容必须是有效的 XML 字符串。 此参数可以为 NULL。

[in] async

定义异步结构以包含可选用户上下文和强制回调函数。 有关详细信息，请参阅 WSMAN_SHELL_ASYNC。 此参数不能为 NULL。

[out] command

此句柄在成功调用时返回，用于发送和接收数据以及发出命令信号。 完成使用此句柄后，通过调用 WSManCloseCommand 方法将其关闭。 此参数不能为 NULL。

返回值

无

要求