Condividi tramite

WSMAN_PLUGIN_REQUEST struttura (wsman.h)

  • Articolo

Specifica le informazioni per una richiesta di plug-in. Un puntatore a una struttura WSMAN_PLUGIN_REQUEST viene passato a tutti i punti di ingresso dell'operazione all'interno del plug-in. Tutti i metodi di notifica dei risultati usano questo puntatore per corrispondere al risultato con la richiesta. Tutte le informazioni nella struttura rimarranno valide fino a quando il plug-in chiama WSManPluginOperationComplete nell'operazione.

Sintassi

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;

Members

senderDetails

Puntatore a una struttura WSMAN_SENDER_DETAILS che specifica i dettagli sul client che ha avviato la richiesta.

locale

Specifica le impostazioni locali in cui l'utente ha richiesto di trovarsi i risultati. Se le impostazioni locali richieste non sono disponibili, sono disponibili le opzioni seguenti:

  • Vengono usate le impostazioni locali di sistema.
  • La richiesta viene rifiutata con un errore delle impostazioni locali non valide.
Qualsiasi chiamata al plug-in avrà le impostazioni locali del thread impostate sulle impostazioni locali specificate in questo membro. Se il plug-in ha altri thread che funzionano sulla richiesta, il plug-in dovrà impostare le impostazioni locali di conseguenza su ogni thread usato.

resourceUri

Specifica l'URI della risorsa per questa operazione.

operationInfo

Puntatore a una struttura WSMAN_OPERATION_INFO che contiene informazioni aggiuntive sull'operazione. Alcune delle informazioni contenute in questa struttura saranno NULL perché non tutti i parametri sono rilevanti per tutte le operazioni.

shutdownNotification

Se l'operazione viene annullata, il membro shutdownNotification è impostato su TRUE.

shutdownNotificationHandle

Se l'operazione viene annullata, shutdownNotification viene segnalato.

dataLocale

Commenti

Le operazioni devono segnalare il callback per l'operazione per indicare che è stato arrestato. Le operazioni vengono annullate in modo gerarchico per garantire che tutte le operazioni di follow-on vengano annullate prima delle operazioni di primo livello. Un plug-in ha due modi per gestire l'annullamento di un'operazione. Prima di tutto, il plug-in può controllare il valore booleano shutdownNotification se esegue l'iterazione tramite un set di risultati. In secondo luogo, se il plug-in è più asincrono, è possibile usare shutdownNotificationHandle durante l'accodamento di thread di notifica asincroni.

Requisiti

Requisito Valore
Client minimo supportato Windows 7
Server minimo supportato Windows Server 2008 R2
Intestazione wsman.h
Componente ridistribuibile Windows Management Framework in Windows Server 2008 con SP2, Windows Vista con SP1 e Windows Vista con SP2