WSMAN_PLUGIN_REQUEST-Struktur (wsman.h)

Gibt Informationen für eine Plug-In-Anforderung an. Ein Zeiger auf eine WSMAN_PLUGIN_REQUEST-Struktur wird an alle Vorgangseingangspunkte innerhalb des Plug-Ins übergeben. Alle Ergebnisbenachrichtigungsmethoden verwenden diesen Zeiger, um das Ergebnis mit der Anforderung abzugleichen. Alle Informationen in der Struktur bleiben gültig, bis das Plug-In WSManPluginOperationComplete für den Vorgang aufruft.

Syntax

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;

Member

senderDetails

Ein Zeiger auf eine WSMAN_SENDER_DETAILS-Struktur , die Details zum Client angibt, der die Anforderung initiiert hat.

locale

Gibt das Gebietsschema an, in dem der Benutzer die angeforderten Ergebnisse enthalten soll. Wenn das angeforderte Gebietsschema nicht verfügbar ist, stehen die folgenden Optionen zur Verfügung:

• Das Systemgebietsschema wird verwendet.
• Die Anforderung wird mit einem ungültigen Gebietsschemafehler abgelehnt.

Bei jedem Aufruf des Plug-Ins wird das Gebietsschema für den Thread auf das Gebietsschema festgelegt, das in diesem Element angegeben ist. Wenn das Plug-In über andere Threads verfügt, die an der Anforderung arbeiten, muss das Plug-In das Gebietsschema für jeden Thread, den es verwendet, entsprechend festlegen.

resourceUri

Gibt den Ressourcen-URI für diesen Vorgang an.

operationInfo

Ein Zeiger auf eine WSMAN_OPERATION_INFO-Struktur , die zusätzliche Informationen zum Vorgang enthält. Einige der Informationen in dieser Struktur sind NULL , da nicht alle Parameter für alle Vorgänge relevant sind.

shutdownNotification

Wenn der Vorgang abgebrochen wird, wird der ShutdownNotification-Member auf TRUE festgelegt.

shutdownNotificationHandle

Wenn der Vorgang abgebrochen wird, wird shutdownNotification signalisiert.

dataLocale

Hinweise

Vorgänge müssen den Rückruf für den Vorgang signalisieren, um anzugeben, dass er heruntergefahren wurde. Vorgänge werden hierarchisch abgebrochen, um sicherzustellen, dass alle Folgevorgänge vor den Vorgängen der obersten Ebene abgebrochen werden. Ein Plug-In hat zwei Möglichkeiten, den Abbruch eines Vorgangs zu verarbeiten. Zunächst kann das Plug-In den wert shutdownNotification Boolean überprüfen, wenn er eine Reihe von Ergebnissen durchläuft. Zweitens, wenn das Plug-In asynchroner ist, kann shutdownNotificationHandle beim Anstehen asynchroner Benachrichtigungsthreads verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Kopfzeile	wsman.h
Verteilbare Komponente	Windows Management Framework unter Windows Server 2008 mit SP2, Windows Vista mit SP1 und Windows Vista mit SP2