Compartilhar via

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

  • Artigo

Define o retorno de chamada do shell para um plug-in. Essa função é chamada quando uma solicitação para um novo shell é recebida. Todos os plug-ins de Gerenciamento Remoto do Windows que dão suporte a operações de shell precisam implementar esse retorno de chamada.

O nome do ponto de entrada da DLL deve ser WSManPluginShell.

Sintaxe

WSMAN_PLUGIN_SHELL WsmanPluginShell;

void WsmanPluginShell(
  PVOID pluginContext,
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  WSMAN_SHELL_STARTUP_INFO *startupInfo,
  WSMAN_DATA *inboundShellInformation
)
{...}

Parâmetros

pluginContext

Especifica o contexto que foi retornado por uma chamada para o método WSManPluginStartup . Esse parâmetro representa uma inicialização de aplicativo específica de um plug-in WinRM.

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.

flags

Reservado para uso futuro. Deve ser definido como zero.

startupInfo

Um ponteiro para uma estrutura WSMAN_SHELL_STARTUP_INFO que contém informações de inicialização para o shell.

inboundShellInformation

Um ponteiro para uma estrutura WSMAN_DATA que especifica um objeto de entrada opcional que contém dados extras para o shell.

Retornar valor

Nenhum

Comentários

O plug-in WinRM (WinRM) chama WSManPluginReportContext para registrar um contexto de shell para o shell. Todas as operações nesse shell passam para esse contexto. Se o shell tiver sido desligado ou o plug-in verificar o parâmetro requestDetails e relatar que a operação foi cancelada, o plug-in deverá chamar WSManPluginOperationComplete. Todos os parâmetros passados são válidos até que o plug-in winRM chame WSManPluginOperationComplete.

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, Windows Vista com SP1 e Windows Vista com SP2