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。
返回值
无
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 |
最低受支持的服务器 | Windows Server 2012 |
目标平台 | Windows |
标头 | wsman.h |
Library | WsmSvc.lib |
DLL | WsmSvc.dll |