WSManPluginReceiveResult-Funktion (wsman.h)

Artikel
08/28/2023

Meldet Ergebnisse für den WSMAN_PLUGIN_RECEIVE-Plug-In-Aufruf und wird von den meisten Shell-Plug-Ins verwendet, die Ergebnisse zurückgeben. Nachdem alle Daten empfangen wurden, muss die WSManPluginOperationComplete-Methode aufgerufen werden.

Syntax

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
);

Parameter

[in] requestDetails

Ein Zeiger auf eine WSMAN_PLUGIN_REQUEST-Struktur , die den Ressourcen-URI, die Optionen, das Gebietsschema, das Shutdown-Flag und das Handle für die Anforderung angibt.

[in] flags

Für die zukünftige Verwendung reserviert. Muss auf 0 festgelegt werden.

[in, optional] stream

Gibt den Stream an, dem die Daten zugeordnet sind. Jeder Stream kann verwendet werden, aber die Standardstreams sind STDIN, STDOUT und STDERR.

[in, optional] streamResult

Ein Zeiger auf eine WSMAN_DATA-Struktur , die das Ergebnisobjekt angibt, das an den Client zurückgegeben wird. Das Ergebnis kann entweder im Binärformat oder im XML-Format vorliegen.

[in, optional] commandState

Gibt den Status des Befehls an. Dieser Parameter muss entweder auf einen der folgenden Werte oder auf einen vom Plug-In definierten Wert festgelegt werden.

WSMAN_RECEIVE_STATE_NONE

Der Vorgang erfordert keine Aktion.

WSMAN_RECEIVE_STATE_NORMAL_TERMINATION

Der Vorgang wurde normal beendet.

WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION

Der Vorgang wurde unerwartet beendet.

WSMAN_RECEIVE_STATE_WAITING

Der Vorgang wartet auf die Eingabe.

WSMAN_RECEIVE_STATE_INPUT_REQUIRED

Für den Vorgang ist eine Befehlszeileneingabe erforderlich.

[in] exitCode

Wird in allen Fällen ignoriert, außer wenn commandStateentweder WSMAN_RECEIVE_STATE_NORMAL_TERMINATION oder WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION ist. Jedes Ergebnis kann separate Fehlercodes aufweisen. Wenn beim Befehl oder Stream ein Fehler aufgetreten ist, muss das Plug-In die WSManPluginOperationComplete-Methode aufrufen.

Rückgabewert

Keine

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Zielplattform	Windows
Kopfzeile	wsman.h
Bibliothek	WsmSvc.lib
DLL	WsmSvc.dll
Verteilbare Komponente	Windows Management Framework unter Windows Server 2008 mit SP2 und Windows Vista mit SP2

Freigeben über