Compartilhar via

WSMAN_PLUGIN_SIGNAL função de retorno de chamada (wsman.h)

  • Artigo

Define o retorno de chamada de sinal para um plug-in. Essa função é chamada quando um sinal de entrada é recebido de uma chamada de cliente.

O nome do ponto de entrada da DLL para esse método deve ser WSManPluginSignal.

Sintaxe

WSMAN_PLUGIN_SIGNAL WsmanPluginSignal;

void WsmanPluginSignal(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD flags,
  [in]           PVOID shellContext,
  [in, optional] PVOID commandContext,
  [in]           PCWSTR code
)
{...}

Parâmetros

[in] requestDetails

Um ponteiro para uma estrutura WSMAN_PLUGIN_REQUEST que especifica o URI do recurso, as opções, a localidade, o sinalizador de desligamento e o identificador da solicitação.

[in] flags

Reservado para uso futuro. Deve ser zero.

[in] shellContext

Especifica o contexto que foi recebido quando o shell foi criado.

[in, optional] commandContext

Se essa solicitação for destinada a um comando e não a um shell, esse será o contexto retornado da operação winrm create ; caso contrário, esse parâmetro será NULL.

[in] code

Especifica o sinal recebido do cliente. Os códigos a seguir são comuns.

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

O shell ou a janela do Prompt de Comando foi fechada. O plug-in deve chamar a função WSManPluginOperationComplete .

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

O sinal para CTRL+C foi recebido e o processo foi interrompido. O plug-in deve chamar a função WSManPluginOperationComplete .

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

O sinal de CTRL+BREAK foi recebido e o processo foi interrompido. O plug-in deve chamar a função WSManPluginOperationComplete .

Retornar valor

Nenhum

Comentários

Um sinal pode ser recebido para processar uma sequência CTRL+C ou um dos muitos outros tipos de sinais personalizados. O retorno de chamada é chamado uma vez para cada sinal recebido. O plug-in determina quais sinais fazem com que os comandos e/ou shells sejam desligados. Como os sinais são específicos do shell, o plug-in deve iniciar o desligamento chamando o método WSManPluginOperationComplete . Para cada chamada, o plug-in deve chamar WSManPluginOperationComplete para confirmar o recebimento e permitir que o próximo sinal seja recebido.

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
Redistribuível Windows Management Framework no Windows Server 2008 com SP2 e Windows Vista com SP2