Função WSManPluginReceiveResult (wsman.h)

Artigo
03/04/2024

Relata os resultados do WSMAN_PLUGIN_RECEIVE chamada de plug-in e é usado pela maioria dos plug-ins de shell que retornam resultados. Depois que todos os dados são recebidos, o método WSManPluginOperationComplete deve ser chamado.

Sintaxe

DWORD WSManPluginReceiveResult(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD                flags,
  [in, optional] PCWSTR               stream,
  [in, optional] WSMAN_DATA           *streamResult,
  [in, optional] PCWSTR               commandState,
  [in]           DWORD                exitCode
);

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

[in, optional] stream

Especifica o fluxo ao qual os dados estão associados. Qualquer fluxo pode ser usado, mas os fluxos padrão são STDIN, STDOUT e STDERR.

[in, optional] streamResult

Um ponteiro para uma estrutura WSMAN_DATA que especifica o objeto de resultado retornado ao cliente. O resultado pode estar no formato binário ou XML.

[in, optional] commandState

Especifica o estado do comando. Esse parâmetro deve ser definido como um dos valores a seguir ou para um valor definido pelo plug-in.

WSMAN_RECEIVE_STATE_NONE

A operação não requer nenhuma ação.

WSMAN_RECEIVE_STATE_NORMAL_TERMINATION

A operação foi encerrada normalmente.

WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION

A operação foi encerrada inesperadamente.

WSMAN_RECEIVE_STATE_WAITING

A operação está aguardando entrada.

WSMAN_RECEIVE_STATE_INPUT_REQUIRED

A operação requer entrada de linha de comando.

[in] exitCode

Ignorado em todos os casos, exceto quando commandState é WSMAN_RECEIVE_STATE_NORMAL_TERMINATION ou WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION. Cada resultado pode ter códigos de erro separados. Se o comando ou fluxo tiver falhado, o plug-in deverá chamar o método WSManPluginOperationComplete .

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

Compartilhar via