Compartilhar via


Função WSManSignalShell (wsman.h)

Envia um código de controle para um comando existente ou para o próprio shell.

Sintaxe

void WSManSignalShell(
  [in]           WSMAN_SHELL_HANDLE     shell,
  [in, optional] WSMAN_COMMAND_HANDLE   command,
                 DWORD                  flags,
  [in]           PCWSTR                 code,
  [in]           WSMAN_SHELL_ASYNC      *async,
  [out]          WSMAN_OPERATION_HANDLE *signalOperation
);

Parâmetros

[in] shell

Especifica o identificador retornado por uma chamada WSManCreateShell . Esse parâmetro não pode ser NULL.

[in, optional] command

Especifica o identificador de comando retornado por uma chamada WSManRunShellCommand . Se esse valor for NULL, o código de sinal será enviado para o shell.

flags

Reservado para uso futuro. Deve ser definido como zero.

[in] code

Especifica o código de sinal a ser enviado para o comando ou shell. Os códigos a seguir são comuns.

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

O shell ou a janela do Prompt de Comando foi fechada.

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

O sinal para CTRL+C foi recebido e o processo foi interrompido.

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

O sinal de CTRL+BREAK foi recebido e o processo foi interrompido.

[in] async

Define uma estrutura assíncrona. A estrutura assíncrona contém um contexto de usuário opcional e uma função de retorno de chamada obrigatória. Consulte a estrutura WSMAN_SHELL_ASYNC para obter mais informações. Esse parâmetro não pode ser NULL e deve ser fechado chamando o método WSManCloseOperation .

[out] signalOperation

Define o identificador de operação para a operação de sinal. Esse identificador é retornado de uma chamada bem-sucedida da função e pode ser usado para cancelar de forma assíncrona a operação de sinal. Esse identificador deve ser fechado chamando o método WSManCloseOperation . Esse parâmetro não pode ser NULL.

Retornar valor

Nenhum

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
Plataforma de Destino Windows
Cabeçalho wsman.h
Biblioteca WsmSvc.lib
DLL WsmSvc.dll
Redistribuível Windows Management Framework no Windows Server 2008 com SP2, Windows Vista com SP1 e Windows Vista com SP2