Compartilhar via

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

  • Artigo

Define o retorno de chamada de recebimento para um plug-in. Essa função é chamada quando uma solicitação de entrada para receber dados é recebida.

O nome do ponto de entrada DLL deve ser WSManPluginReceive.

Sintaxe

WSMAN_PLUGIN_RECEIVE WsmanPluginReceive;

void WsmanPluginReceive(
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  PVOID shellContext,
  PVOID commandContext,
  WSMAN_STREAM_ID_SET *streamSet
)
{...}

Parâmetros

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 zero.

shellContext

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

commandContext

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

streamSet

Uma estrutura WSMAN_STREAM_ID_SET que contém uma lista de fluxos para os quais os dados devem ser recebidos. Se essa lista estiver vazia, todos os fluxos que foram configurados no shell estarão implícitos, o que significa que todos os fluxos estão disponíveis.

Retornar valor

Nenhum

Comentários

Com base na solicitação do cliente, a função de retorno de chamada WSMAN_PLUGIN_RECEIVE pode ser chamada no shell e/ou no comando. O plug-in chama o método WSManPluginReceiveResult para cada parte dos dados que precisam ser enviados de volta para o cliente. Depois que todos os dados forem enviados, o plug-in chamará WSManPluginOperationComplete para encerrar o fluxo. Todos os parâmetros passados são válidos até que o plug-in do WinRM (Gerenciamento Remoto do Windows) chame WSManPluginOperationComplete.

Requisitos

   
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