Função WSManPluginGetOperationParameters (wsman.h)

Artigo
08/28/2023

Obtém informações operacionais para itens como tempos limite e restrições de dados associados à operação. Um plug-in não deve usar esses parâmetros para nada além de fins informativos.

Sintaxe

DWORD WSManPluginGetOperationParameters(
  [in]  WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]  DWORD                flags,
  [out] WSMAN_DATA           *data
);

Parâmetros

[in] requestDetails

Um ponteiro para uma estrutura de 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

Especifica as opções disponíveis para recuperação. Esse parâmetro deve ser definido como um dos valores a seguir ou como um valor definido pelo plug-in.

WSMAN_PLUGIN_PARAMS_MAX_ENVELOPE_SIZE (1)

Especifica o tamanho máximo do pacote de resposta da operação. O tamanho inclui o tamanho dos dados junto com a sobrecarga soap (Simple Object Access Protocol).

Nota Algumas operações têm uma única chamada para o plug-in que pode fazer com que várias viagens de ida e volta ocorram. Se nenhuma solicitação estiver aguardando dados quando esse método for chamado, o tamanho máximo do envelope para o pacote anterior será dado.

WSMAN_PLUGIN_PARAMS_TIMEOUT (2)

Especifica o tempo limite da operação atual.

WSMAN_PLUGIN_PARAMS_REMAINING_RESULT_SIZE (3)

Especifica quanto espaço resta para os dados da operação atual. O tamanho é baseado no tipo de operação. Por exemplo, esse sinalizador representaria o tamanho do item de resultado único para uma operação get. Para enumerações, o tamanho diminuirá depois que cada objeto for adicionado. Depois que o pacote atual tiver sido preenchido com enumerações e obter operações, ele será retornado ao cliente mesmo que mais dados estejam sendo aceitos e armazenados em cache.

Nota Algumas operações têm uma única chamada para o plug-in que pode fazer com que várias viagens de ida e volta ocorram. Se nenhuma solicitação estiver aguardando dados quando esse método for chamado, o tamanho restante será dado para um item armazenado em cache.

WSMAN_PLUGIN_PARAMS_LARGEST_RESULT_SIZE (4)

Especifica o tamanho máximo dos dados para a operação atual.

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_LOCALE (5)

Especifica a localidade do idioma que foi solicitada pelo cliente para a operação.

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_DATA_LOCALE (6)

Especifica a localidade do idioma dos dados solicitados pelo cliente.

[out] data

Um ponteiro para uma estrutura WSMAN_DATA que especifica o objeto de resultado.

Retornar valor

O método retornará NO_ERROR se tiver êxito; caso contrário, ele retorna um código de erro. Veja a seguir os códigos de erro mais comuns:

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