Compartilhar via

estrutura WSMAN_PLUGIN_REQUEST (wsman.h)

  • Artigo

Especifica informações para uma solicitação de plug-in. Um ponteiro para uma estrutura WSMAN_PLUGIN_REQUEST é passado para todos os pontos de entrada de operação dentro do plug-in. Todos os métodos de notificação de resultado usam esse ponteiro para corresponder o resultado com a solicitação. Todas as informações na estrutura permanecerão válidas até que o plug-in chame WSManPluginOperationComplete na operação.

Sintaxe

typedef struct _WSMAN_PLUGIN_REQUEST {
  WSMAN_SENDER_DETAILS *senderDetails;
  PCWSTR               locale;
  PCWSTR               resourceUri;
  WSMAN_OPERATION_INFO *operationInfo;
  BOOL                 shutdownNotification;
  HANDLE               shutdownNotificationHandle;
  PCWSTR               dataLocale;
} WSMAN_PLUGIN_REQUEST;

Membros

senderDetails

Um ponteiro para uma estrutura WSMAN_SENDER_DETAILS que especifica detalhes sobre o cliente que iniciou a solicitação.

locale

Especifica a localidade em que o usuário solicitou resultados. Se a localidade solicitada não estiver disponível, as seguintes opções estarão disponíveis:

  • A localidade do sistema é usada.
  • A solicitação é rejeitada com um erro de localidade inválido.
Qualquer chamada para o plug-in terá a localidade no thread definida como a localidade especificada neste membro. Se o plug-in tiver outros threads funcionando na solicitação, o plug-in precisará definir a localidade adequadamente em cada thread que ele usa.

resourceUri

Especifica o URI do recurso para esta operação.

operationInfo

Um ponteiro para uma estrutura WSMAN_OPERATION_INFO que contém informações extras sobre a operação. Algumas das informações nessa estrutura serão NULL porque nem todos os parâmetros são relevantes para todas as operações.

shutdownNotification

Se a operação for cancelada, o membro shutdownNotification será definido como TRUE.

shutdownNotificationHandle

Se a operação for cancelada, shutdownNotification será sinalizado.

dataLocale

Comentários

As operações devem sinalizar o retorno de chamada para a operação para indicar que ela foi desligada. As operações são canceladas de forma hierárquica para garantir que todas as operações de acompanhamento sejam canceladas antes das operações de nível superior. Um plug-in tem duas maneiras de lidar com o cancelamento de uma operação. Primeiro, o plug-in pode marcar o valor booliano shutdownNotification se iterar por meio de um conjunto de resultados. Em segundo lugar, se o plug-in for mais assíncrono por natureza, shutdownNotificationHandle poderá ser usado ao enfileirar threads de notificação assíncrona.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
Cabeçalho wsman.h
Redistribuível Windows Management Framework no Windows Server 2008 com SP2, Windows Vista com SP1 e Windows Vista com SP2