Compartir a través de

Función WSManRunShellCommandEx (wsman.h)

  • Artículo

Proporciona la misma funcionalidad que la función WSManRunShellCommand , con la adición de una opción de identificador de comando. Si el servidor admite el protocolo, creará la instancia de comando mediante el identificador especificado por el cliente. Si ya existe un comando con el identificador especificado, el servidor no podrá crear la instancia de comando. Esta nueva funcionalidad solo está disponible cuando la aplicación cliente pasa la marca WSMAN_FLAG_REQUESTED_API_VERSION_1_1 como parte de la llamada a la función WSManInitialize .

Sintaxis

void WSManRunShellCommandEx(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandId,
  [in]           PCWSTR                commandLine,
  [in, optional] WSMAN_COMMAND_ARG_SET *args,
  [in, optional] WSMAN_OPTION_SET      *options,
  [in]           WSMAN_SHELL_ASYNC     *async,
  [out]          WSMAN_COMMAND_HANDLE  *command
);

Parámetros

[in, out] shell

Especifica el identificador de shell devuelto por la llamada de WSManCreateShell . Este parámetro no puede ser NULL.

flags

Reservado para uso futuro. Debe ser 0.

[in] commandId

Identificador de comando especificado por el cliente.

[in] commandLine

Define una cadena terminada en NULL necesaria que representa el comando que se va a ejecutar. Normalmente, el comando se especifica sin ningún argumento, que se especifican por separado. Sin embargo, un usuario puede especificar la línea de comandos y todos los argumentos mediante este parámetro. Si se especifican argumentos para el parámetro commandLine, el parámetro args debe ser NULL.

[in, optional] args

Puntero a una estructura WSMAN_COMMAND_ARG_SET que define una matriz de valores de argumento, que se pasan al comando al crear. Si no se requiere ningún argumento, este parámetro debe ser NULL.

[in, optional] options

Define un conjunto de opciones para el comando . Estas opciones se pasan al servicio para modificar o refinar la ejecución del comando. Este parámetro puede ser NULL. Para obtener más información sobre las opciones, vea WSMAN_OPTION_SET.

[in] async

Define una estructura asincrónica. La estructura asincrónica contiene un contexto de usuario opcional y una función de devolución de llamada obligatoria. Consulte la estructura WSMAN_SHELL_ASYNC para obtener más información. Este parámetro no puede ser NULL y debe cerrarse llamando al método WSManCloseCommand .

[out] command

Define el objeto de comando asociado a un comando dentro de un shell. Este identificador se devuelve en una llamada correcta y se usa para enviar y recibir datos y para indicar el comando. Este identificador debe cerrarse llamando al método WSManCloseCommand . Este parámetro no puede ser NULL.

Valor devuelto

None

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8
Servidor mínimo compatible Windows Server 2012
Plataforma de destino Windows
Encabezado wsman.h
Library WsmSvc.lib
Archivo DLL WsmSvc.dll